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CRT DISPLAY PRODUCTS 





1.0 INTRODUCTION 

, Rastersscan CRT (Cathode Ray Tube) displays 
form the principle communication link between 
computers and users in business, science and 
educational applications. The trend toward using 
high-resolution displays to enhance information 
transfers between man and ~=machine_ is 
accelerating. 


As CRT terminals become increasingly sophis- 
ticated, the designer is faced -with many new 
problems in areas of data manipulation and display. 
The high-resolution screen necessary to display a 
full-size typewriter page results in pixel rates 
exceeding 50 MHz. Additionally, the use of 
. Microprocessor technology in modern terminal 
. .designs has transferred the editing tasks from Ne 
host system to the terminal itself. 


CRT terminal designs can be divided ‘into two 
categories. Alphanumeric terminals are used in 
Office workstations. They incorporate features 
such as flexible attribute handling, proportional 
Spacing. of characters, split-screens or multiple 
window display, smooth-scrolling of windows, and 
variable character width and height in full-page, 


of the flexibility. However, because of the high 
processing power needed to generate the display 
and the large display memory storing the, bit-map, 
an alphanumeric terminal based on bit- -mapped 
graphic is more expensive and takes up more 
board space than a dedicated, alphanumeric CRT 
subsystem based on the CRT Controller chip set. 
On. the other side, a CRTC-based system can 
handle limited bit-mapped graphics to display pie 


.charts or bar graphs in business-type applications. 


1.1 ALPHANUMERIC DISPLAY PRODUCTS 


Figure 1.1 shows a typical proportional-spacing 


' application based on the CRT Controller chip set. 


132x60 screen formats. The video subsystem of a — 


CRT terminal with these sophisticated features can 
be implemented with as few as three devices. This 
significantly reduces IC and system development 
- cost and board space without sacrificing perform- 
ance. The three devices.consist of the Am8052 Al- 
phanumeric CRT Controller (CRTC), the Am8152A 
Video System Controller (VSC), and a character 
font generator. This subsystem talks to the system 
bus on one side and generates a high- speed pixel 
stream on the other. This ene set is subject of this 
handbook. 


The distinctive characteristics of this subsystem 
are as following: 


Up to 80 MHz video dot rate for high- resolution, | 
flicker-free displays. 


Linked-list display data structure in system 
memory simplifying text-editing tasks. 


Background or window smooth-scroll capability 
without external MSI or software overhead. 


User-friendly, 16-bit CPU interface. Compatible 
with 8086, Z8000, and 68000 CPUs. 16-Mbyte 
memory addressing capability. 


The chip set Capabilities are contributed to the 
CRTC and VSC as described below: 


Am8052. The CRT Controller (CRTC), is a 
general-purpose interface device for raster scan 


_CRT displays. The on-chip DMA controller inter- 


Terminals of the second category employ a bit- : 


mapped graphic display. The main application area 
_ for these terminals are engineering workstations in 
CAD/CAM systems. In bit-mapped displays, each 
pixel can be set or reset independently. A graphic 
controller with a high processing power is needed 
to update a high-resolution screen containing 
more than one million pixels in a reasonable time. 


The Am815x. family supports this kind of - 


application. 


New designs of high-end alphanumeric CRT 


eye tend to use bit- mapped displays because 


prets a linked-list data structure in system memory 
defining the text displayed on the screen. This 
simplifies text-editing tasks. It supports attributes 
such as subscript, superscript, underline, multiple 
cursors and blinking. User-definable attributes 
provide flexibility. Windows and background can — 
bea smooth- scrolled at Beer eatiene rates. 


The CRTC is agisronenied and fully user-— 


programmable. The frame timing and operallig | 
mode are initialized ee hostCPU. © | 


Am8152A. The Video System Controller is ba- 
sically a programmable (2- to 17-bit) shift register. 


CHARACTER AND 
ATTRIBUTE ROM 


Am8052 


| Figure 1-1 Typical Application 


It serializes the character slices supplied by the 
character font generator. Attributes such as 
highlight and reverse video are incorporated in the 
serial pixel stream put out. The VSC provides two 
video outputs: a two-bit digital output and a four- 
level analog (composite). video output. An on- 
chip, crystal-driven oscillator provides the pixel 
shift clock (dot clock), the character clock, and the 
system clock. | 


/ 


1.2 ADVANCED DISPLAY FEATURES 


State-of-the-art, 
fancy text display features such as proportional 





CRT . 
MONITOR * 


PALETTE - 


a 
8 
ke nee nee 


or 
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~ system memory. However, the editing response 


letter-quality printers support: 


spacing with block justification and double print. 


Workstations for word processing should. be able 
to display edited text on the screen that looks like 
the -print-out of these letter-quality. printers, in 
order to make the word processing task more 
ergonomical: for the operator. For example, it is 
intolerable that some workstations display the 
beginning and end of an underline with a special 
character sequence instead of simply underlining 
the string. Additionally, it should support features 
like highlighting, which is. equivalent to double 
print in case of a printer, blinking of characters and 
multiple cursors to emphasize parts of the text. 


Vertical smooth-scroll will become a_ standard 
feature of future. designs. Smooth-scrolling is 
much more ergonomical for the user. Also helpful 
are windows (overlaid on the displayed page) to 
provide temporary information about issued 
commands. oo ; 


Additionally, a CRT controller should: supply a 


A. 4,3). 


time is shorter compared to a system using linear. 
data structures. 


The features expected of a state-of-the-art CRT 
controller will now be discussed in more detail. 
The CRT controller chip set implements all these 
features insilicon. 


Linked-List Data Structure 


In standard CRT subsystems the display data is 
organized as contiguous memory blocks. These . 
blocks are associated with video frames and stored 
in special memory called video refresh memory. 
When editing tasks like character or line insertion 
or deletion are to be executed, the CPU has to 
move blocks of the display data. This time- 
consuming operation slows down the editing 
process. 


Text editing becomes much more elegant at 
faster when operating on a linked-list data structure 
where the display data is organized in small strings, 
usually rows, glued together by pointers (Figures 
The advantage of the linked-list data 
structure becomes obvious when looking at the 
éxecution speed of editing tasks. A line can be 
inserted or deleted by modifying one pointer 


instead of moving half the screen down, thereby 


The 


display data structure organized as a linked-list in. | 


increasing the execution speed significantly. 
Pages’ can be swapped simply by acl one . 
pointer. 


linked-list date structure has a second 
advantage: If the display data is stored in the main 
system memory the CRT controller can directly 
fetch the data from the list the word processor is 


4-2. 
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) ‘ Figure 1-3 Linked-List Display Data Management: Windows 
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‘operating on. This eliminates the need of setting 
up a “pede list of display data. . 


In an “Am8052- based video system, ‘the: digplay’s 


ground Row Control Block. ‘The row segmentation 


| feature i is also available for windows. 


data is stored in system memory and is easily: ac- 


cessible by the host CPU when ‘executing display- 
_ editing tasks. The display data consisting of char- 
acters and their attributes is grouped into Strings © 
called segments. One or more segments build Up. 


- permit overlapping or adjacent windows, 


Virtual Windows or Split Screens 


Although the rules of window positioning do not 
the 
background and window data structures can be 
used to implement virtual horizontally or vertically 


a row. These segments are tied together by a aligned windows. This can be best described 


linear list of pointers containing in Row Control 
Blocks. Each Row Control Block holds all 
information relevant to describe an entire character 
row on the screen. Row Control Blocks again are 
chained’ via pointers; each block points to its 
successor. 


One block ineaied at the top of the linked-list 
defines screen attributes such as cursor type, blink 
rate, and positioning. This Main Definition Block is 
pointed to by a pointer stored inside the CRTC. 


The CRTC interprets the linked-list and transfers 
the character code strings and attributes 
sequentially to the character font generator. The 
character slice output of the character font 
generator is then serialized by the companion part 
of the Am8052, the Video eystem Controller 
(VSC), and sent to the monitor. . 


Windows 


Windows ‘are text blocks ‘overlaying the 
background to provide temporary information for 
_ the viewer. Windows can be displayed or removed 
without corrupting the background. Windows are 
defined by a linked-list data structure similar to the 
background data structure. The Am8052 can 
support any number of windows as long:as they 
are vertically separated by at least two character 
rows. Any number of windows or the background 
may be scrolled. 


The Top of Window sauistak inside the Am8052 
points to the beginning of the window linked-list, 
the Window Definition Block for the top-most 
window. The Window Definition logically is similar 
to the Main Definition Block of the background; it 
contains the general characteristics of this parti- 
cular window (for example, size and positioning). 


‘Each Window Definition Block links to the next Win- 

dow Definition Block. Window Definition Blocks 
need to be arranged in the sequence the windows 
are supposed to appear on the display (the top- 
_most window first, the poriom window last). 


The Window Row Control Block pointer located in 
the Window Definition Block links to the first Win- 


- segments: 


using the illustration in Figure 1.4. This sample 
display consists ‘of two rows with each two 
“ONE” and “TWO,” “THREE” .and 
“FOUR.” The user wishes to be able to scroll any 
of these segments at a given time. The ‘window 
positioning rules do not permit assignment of all 
four segments as windows. However, any of these 
four segments can be dynamically assigned to be a 
window; anyone of these windows can be scrolled 
independently from the other three. This gives 
the viewer the illusion of aligned windows. 


Smooth-Scrolling 


Vertical smooth-scrolling is the gradual 
replacement of a character row on a scan line by. 
scan line basis. The visual effect is more eye- 
pleasing to the viewer and will become an 
ergonomical requirement for future terminal 
designs. The smooth- scroll of the entire screen is 
a relatively easy task and can be accomplished with 
a minimum of hardware. However, smooth-scrol- 
ling an overlaid window or smooth-scrolling the 
background when displaying windows is a much > 
more sophisticated task. If a window is smooth- 


scrolled, text seems to appear and disappear with- . 


in the window while the background stays abso- 
lutely stable (Figure 1.5). If, on the other hand, the 
background is scrolled, then the background text 


will appear to pass under the window. 


dow Row Control Block which is similar to the back- 
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Vertical smooth-scrolling of the background or of 
windows is executed requiring very’ few 
interactions of the host CPU. Only when a row is 
totally scrolled in or out does the CRTC interrupt - 
the CPU to relink the data structure. The scroll rate’ 

being programmable covers the range from very | 
low-speed scrolling, where the eye can identify the 
scan line stepping, to high-speed scrolling, where 
the text moves too fast to be readable. The 

medium speed gives the smoothest effect. ° | 


Attributes 


There are three kinds of attributes which are dis- 
tinguished by the number of characters to ‘which 
they correspond. The screen attributes, such as 
smooth-scroll rate, cursor style, and blink rate, . 
effect the text display of the entire sereen.:. _Row 


ROW CONTROL 
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WINDOW CONTROL 


Figure 1-4 Virtual Window or Split Screens 


attributes, such as scan line count and character 
- positioning within the character cell, are valid for 
entire character rows. The third kind of attribute is 
directly associated with particular characters or 
character strings. Examples of character attributes 
are: highlight, underline, blinking; subscript and 
superscript. 


Many CRT controllers treat characters and 
attributes in the same fashion; they fetch one 
attribute per character. This straightforward 
relation is also the easiest to handle by software. 


However, the price for this scheme is the 


‘increased bus occupancy of the: CRT controller to 


fetch 24 bits per character compared to 8 bits per 
character: in applications requiring no’ attribute 
fetches at all. Especially in high-end alphanumeric 
applications asking for maximum system 
performance, the system designer's goal is to 
keep bus occupancy as low as possible. This 
application asks for a more flexible and less bus 
time consuming attribute architecture. 


Characters are typically uncorrelated along a 


_ character string. Attributes, on the other hand, are 
highly correlated; features such as reverse video 
‘ affect a character string.rather than individual char- 
acters. For this reason, a flexible correspondence 
between characters and attributes can save mem- 
Ory space and can reduce the bus occupancy. 


In demand attribute mode, an attribute is loaded 
only if the attribute characteristics should be 
changed. A flag is inserted in the character list to 
instruct the CRT controller to fetch a new attribute 
word. This attribute word may apply either to the 
next character (unlatched attribute) or to. all 
following characters not invoking. attributes 
‘ (latched attribute). This flag could either be a 
specific character which is not displayed on the 


screen or it could be any bit of the character code . 


(usually the most significant bit). The first option 


allows a 255-character set with the trade-off that a 


flag character has to be inserted when the attribute 
characteristics are to be changed. The second 


option does not require this character string. 


~ modification, but it halves the available character 
set (128 charactercodes).  . 


The CRTC has been designed to allow a great 
versatility in attribute options. Ten attribute bits are 


predefined, four attribute bits are user-definable. If 


the number of user-definable attributes is not suf- 


ficient to satisfy the specific requirements of the ap- | 


plication any predefined attributes may be rede- 
fined to increase the set of user-definable attri- 
butes. The predefined attributes are listed below: 


Highlight. It causes the VSC to switch to the 
highest intensity level when displaying the 
characters. . : 


Reverse. The color of the background and the 
foreground are exchanged. If the normal character 


| WINDOW _ 
WINDOW 


WINDOW _ 





Loe WINDOW 


Strike. Through. 


Figure 1-5 Smooth Scrolling | 


appears white ona black background the reversed 


character will appear black on a white. background. 


Superscript. The character is shifted’ up a de- 
fined number of scan lines. . 


Subscript.. The character is shifted down a de- 
fined number of scan lines. 


- Underline. The character is underlined, the posi- 


tion of the underline is programmable. 


The affected character is. 
struck through; sometimes this attribute is called 
shifted underline. | 


Blink. The affected character blinks at a program- 
mable rate and duty cycle. 


The internal processing of the attribute bits 
superscript and subscript may be disabled to 
access a special character font generator for 
displaying smaller subscript or superscript 
characters. The two attributes listed below cannot 
be redefined as user-definable attribute bits, since 
they do not correspond to an attribute port pin; 
they effect only the internal attribute processing. 


Ignore. The character is not loaded into the line 
buffer: a character can be erased by setting this bit. 


Latched. This attribute word applies to all 
following characters; it gets latched in the CRTC. 


Proportional Spacing 


Proportional spacing has become a standard fea- 
ture of higher performance, letter-quality printers. 
In order to display a text on the screen similar to the. 
printed text on paper, the CRT system should be 






UP 7 | 
BACKGROUND 
BACK ; on 
| ; _BACKGROUND 
DOWN | 2 
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able to support proportional spacing. 


Proportional spacing means that narrow characters 
such as “i” use less space in a character row than 
wider characters such as “W” (Figure 1.6).. The 
screen is no longer divided into a raster. of 


character fields. The number of characters which - 


can be put into one line becomes a function of the 
characters itself. Summarized, it provides a type- 
set look of the text. | 


Text right-justification in proportional-spacing appli- 
cations requires a user-definable number of blank 
pixels to be tailored to characters to get a straight 
right border of the text (Figure 1.7). Trailing blanks 
allow 
unnoticeably. 


In proportional-spacing applications, the character 
font generator also stores, in parallel to the 
character font, the width of the individual character 
and passes this 4-bit value (2...17 pixels) to the 
Video System Controller which uses it to 
determine the divide ratio for the character clock. 
The character clock is modulated along the width 
of the characters in the string. 


The system clock times the DMA transfers when 
the CRTC is bus master: In proportional+spacing 


applications, this clock is also used to determine 
the screen timing (Screen blanking, horizontal and 
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Figure 1-7 Trailing Blanks 


lines to be stretched smoothly and 


vertical sync timing), because the character clock 
rate no longer provides a constant coe for the 
counters. 


Both the character and the system clock are 
divided from the dot clock. A. crystal directly 
connected to the VSC controls the dot clock 
frequency. Internal PLL logic multiplies the crystal 
frequency by five to generate.the dot clock. This 
allows the designer to use inexpensive crystals 
oscillating in fundamental mode even when 
generating dot clocks of 80 MHz. 


Cursors 


The Am8052 supports two kinds of cursors. The 


’ X-Y cursor appears on a programmable X-Y coor- 


dinate. This cursor is tied to this position on the 
screen. When a scroll occurs the cursor will still 
appear on the same location, but will apply to a new 
character. The second cursor type is specified via 
the character attribute word. The cursor is attach- — 
ed to a particular character and will move with the 
character when the text is scrolled. Due to the way 
the two cursors are specified, a screen may have 
only one X-Y cursor (the Main Definition Block can 
store only one pair of coordinates) and as many 
attribute cursors as there characters onthe screen. 


The cursor style is very flexible. 


Examples of 
cursor styles are as follows: 





e Static or blinking underline. 


¢ Blinking by. switching between norinel deeiay 


and blank 

e Blinking by: switching peween normal display 
and reverse ' 

e Reverse character — 


The X-Y cursor and the attribute cursor may have 
- different styles to be able to distinguish them. For 
example, the X-Y cursor may be a blinking under- 
line whereas the attribute cursor may reverse the 
character. 


Host Bus Interface - 


The CRTC can easily be interfaced to most 16-bit 
system buses. In slave mode the CPU initializes 
the CRTC by programming the registers for. the 
timing parameters. After being. activated, the 
CRTC tries to gain the bus mastership to fill the line 
buffers and then starts displaying. The CRTC bus 
interface supports 24-bit linear address buses ~ 
(68000, 8086). and 23-bit eeomemes address 

buses (28000). 








CHAPTER 2 


-Am8052 ARCHITECTURE 





2.1. OVERVIEW 


The Am8052 can be used together with the 
Am8152A Video System Controller, which is 
specially designed to complement the Am8052 
and enhance its displaying capabilities. 


The Am8052, after initialization by the host 
processor, acts as a stand-alone device in the 
following manner: 


e It fetches the data to be displayed from the main 
. Memory using its internal DMA controller. 


® It manipulates the displayable character codes 
along with their attributes. 


e It provides all the timing signals to synchronize 
beam-scanning mu the character-pixel stream. 


° It provides ret features such as size-pro- 
- grammable windows and vertical smooth-scroll. 


The Am8052 is a real-time raster scan display 
controller that keeps track of updating the display 
screen on a character-row basis by toggling its 
internal row-buffers; one being displayed by the 
Display Control Unit while the other two are loaded 
through the DMA interface under control of the 
Row Management Unit. 


All the above operations are sraeniouitad by the 
Video Timing Control Unit and initialized by the 
host processor through bus interface logic. The 
Am8052 block diagram (Figure 2.1) shows the 
functional units and how they interface with each 
other. . | 


Following reset, the Am8052 remains in Slave 
Mode and waits for the host processor to initialize 
the timing and control registers. It also waits for the 
host CPU to load a single register address, 
pointing to the start of the display data list in the 
host memory. 


While in the idle state,.the device holds both 
HSYNC and VSYNC signals inactive (LOW) to pre- 
~vent undefined synchronization to the CRT which 
might damage high bandwidth tubes. It also holds 
the Blank signal active to inhibit the CRT beam. 


Once the device has been initialized, and upon a 
~ command from the CPU, the DMA enters a bus 


request Sequence to update the three internal row 
buffers whenever possible. A row buffer cannot 
be loaded at the same time that it.is. being 
displayed. . 

Thé Row Management Unit governs the loading of 
the characters to be displayed, as well as their 
attributes (whenever they are invoked), into the 
row buffers. This: logic also updates the Display 
Control Registers (not accessible to the user), on a 
row by row basis, as specified by the Row 
Definition Blocks located in main memory. 


With the beginning of Vertical Blank (VBLANK 
going High), the Am8052 terminates any process- 
es/active from the current frame, and starts loading 
the information defining the next frame. It takes 
the Top Of Page Pointer stored in an internal regis- 
ter, and begins loading the Main Definition Block, 
the Window Definition Block (if present) and the - 
first Row Control Block including character and attri- 
bute strings. By the end of vertical blank (VBLANK 
going Low) the Am8052 must have the first inter- 
nal row buffer filled to ensure a flicker-free screen. 


The Display Control Unit combines the character | 
Stream from one of the three row buffers with the 
row- or character-dependent display characteristics 
of these characters. As a result, the Display 
Control Unit provides, on Ro—Ry, the scan line 
address of the one currently being displayed, and 
outputs the sequence of character codes contain- 
ed in this row, on CCp-CC7. These two values 
form the address sent to the Character Font Gener- 
ator. The character code (most significant part of 
the address) points to the matrix of pixels synthe- 
sizing the character on the screen, while the scan 
line number (least significant part of the address) 


indicates which line of the matrix.is to be displayed 


ne 


onthe screen. The Character Font Generator pro- 
vides the resultant line of pixels, which subsequen- 
tly is serialized by the Video System Controller and 
processed according to the various attributes. 


2.2. INTERFACE SIGNALS 

With the exception of CLK1; and CLKo inputs, all 
inputs and outputs of the CRTC are TTL- 
compatible. Figure 2.2 shows the device pin-out. 


| Veod: Vsgo (Ground) 
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Voc1; Voce (+5V Power Supply) 


(For tolerance specification, refer to the DC char- 
amatSlcs) 


CLK, (System Clock, Input). 


~The system clock controls the DMA and peripheral 
portion of the CRITIC and times all memory 
accesses. It requires a timing duty cycle of about 
50% at. its highest frequency and is driven by an 
external timing source, usually the system/CPU 


i 


Attribute outputs of the CRTC. In applications not’ 


‘using proportional spacing, CLK2 is fixed in 
_ frequency ‘and ‘can, therefore, time horizontal and 


clock. In proportional spacing applications, where | 


the character clock (CLK>) is variable, the system 
clock should be used to time the horizontal and 
vertical sync rates. CLK, is not TTL-compatible (for 
specifications refer to the DC_ characteristics). 


Figure 2.3 shows a CLKj/CLKo driver generating a 


clock signal with the required High and Low levels. 


CLKp (Character Clock, Input) 


The character clock times the Character Code and 
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vertical sync (HSYNC and VSYNG). This allows 
CLK;, the system clock, to be unrelated and 
asynchronous to the display timing, CLK is not 
TTL-compatible. 


ADo-AD, 5 
(Address/DataBus, Input/Output) 


The Address/Data Bus is a time- -multiplexed, 
bidirectional, active-High, three-state bus. The. 
presence of addresses is indicated by Address 
Strobe (AS); presence of data is indicated by Data 
Strobe (DS). When the CRTC is in control of the 
system bus (Bus Master), it dominates the AD Bus. 
When the CRTC is idle (Bus Slave), the CPU or oth- 


' er external. devices can control the AD Bus.and 
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may use it to access the internal registers of the 
CRTC. In upper address update cycles (Bus Mas- 
ter Write) the CRTC strobes out the new, most sig- 
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Figure 2-1 Am8052 Block Diagram 
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nificant part of the memory address (upper 7 or 8 
bits). For both Linear and Segmented Addressing 
Mode, this address is output on AD o-AD7; the 
_ interrupt vector is also strobed out on ADp-AD7. 


AS (Address Strobe, Input/Output, 
Active Low) 


Address Strobe is a bidirectional, three-state sig- 
nal. In Slave Mode, this input controls.the internal 
transparent latches at the C/D.and CS inputs. In 
multiplexed address/data bus systems, the rising 


edge of AS latches C/D and CS. In demultiplexed 


address/data bus systems, AS may be held Low to 
make the above-mentioned latches transparent. 


When the CRTC is the bus master, AS is an output 
indicating a valid address on the AD bus. The 
address may be latched with the rising edge of AS. 
During Upper Address Update Cycles, AS and 
R/W are both driven Low. Refer to the Section 6 
for application hints. 


DS (Data Strobe, Input/Output, Active Low) 


Data Strobe is a bidirectional, three-state signal. 
When the CRTC is in the Slave Mode and the host 
CPU is accessing internal registers of the CRTC, 
DS is the input timing the transfer. DS may be 
asynchronous to CLK1. When the CRTC is bus 
master, DS is an output, timing the Memory Read 
_ operation. 


VSYNC F 
Am8052 
CRTC HSYNC 


BLANK 
CURSOR 


CLK, 


ESYNC 
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CS (Chip Select, Input, Active Low) 


The CS input is used by the host CPU to access 
the CRTC's internal registers. CS may be latched 
internally by a Manepalen latch eontralied by the 
AS input. 


WAIT (Wait, Input, Active Low) 
The WAIT input is used to stretch the DS strobe 


whenever the CRTC accesses slow system 
memory. The status of the WAIT signal is sampled 





only on the falling edge of CLK;, in T2 of Bus 


Master Read Cycles. WAIT is ignored during Bus 
Master Writes or Slave Mode register accesses. 


R/W (Read/Write, hapa aly 


Read/Wtite is a bidirectional, three state einai 
R/W indicates the data flow direction for the bus 
transaction under way, and in Master Mode 
remains stable for the length of the bus cycle. 
punng te Idle DMA Cycles, R/W is driven High. 


C/D (Command/Data, Input) 
In Slave Mode, C/D determines whether the host - 
CPU transfers a pointer or data information. In 
Master Mode, C/D is disregarded; _C/D flows 


through a transparent latch controlled by AS. 





CD005191 * 


Figure 2-2 Am8052 Pinout 


DTEN, DREN (Data Transmit Enable, Data... 
Receive Enable, Open Drain Output) 


Data Transmit Enable and Data Receive EAabis 


control external address/data bus transceivers, 
when_required. When:DTEN is Low, the trans- 
ceivers should be_driven out from the CRTC onto 
the bus. When DREN is Low, the transceivers 
_ should be driven from the ‘bus into the CRTC. 
DTEN and DREN are never Low simultaneously. _ 








BRQ (Bus Request, Input/Open Drain Output) 


When the CRTC asserts BRO Low to gain ores 


mastership, it remains Low until the CRTC has 
released the bus. A bus release will occur, when 
the programmed DMA burst length is counted out 
(see Burst Register programming), when an entire 
Internal Row Buffer has been filled, or when DMA 
: preemption is being requested (BAI High). This 
pin is also_an input pin which allows the CRTC to 
sense the BRQ ling. 


BAI (Bus Acknowledge In, Input)’ 


Bus: Acknowledge In is an active- Low input. When 


the CRTC réquires host bus access and has — 


Mode Description 


Slave Mode Pointer Write 
| Slave Mode (not defined) 
‘Slave Mode Data write 
Slave Mode ’ Data Read 
Master Mode Memory Read. 
Master Mode 
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COMPATIBLE 


22pF 





Upper addr.update 









successfully pulled its BRQ -pin,Low,-a BAI Low 


input flags the CRTC..that it can obtain bus 
mastership. ‘BAI is internally synchronized for two | 


periods of CLK? to alleviate metastable problems. 
When the CRTC does not require host bus 
access, the BAI input npelee to ine BAO output 


DMA preemption. may be ifplomented by remov- 
ing BAI during a DMA burst, forcing the CRTC to 
finish the current DMA cycle and to release BRQ. If 
the DMA burst: is not completed and no: other 
device requests the bus (BRQ is High), the CRTC 
reasserts BRQ. The CRTC releases the bus fora 


- minimum of three bus clock (CLK;) eyes: 


BAO (Bus Acknowledge Out, Output, 


Active Ow) 
BAO output is forced Inactive High when the 
CRTC _has obtained bus mastership; otherwise, 
the BAI input ripples out of the ae via the BAO 
output. — 


INT (Interrupt Request, Output, Open 
Drain, Active Low) 


This line is used to indicate an interrupt request to 
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Figure 2-3 CLK4/CLKg Driver 


the host processor. It is driven Low by the CRTC 
until an Interrupt Acknowledge is received on the 
INTACK pin or until the host-CPU acknowledges 
the interrupt by updating Mode Register2. 


INTACK (Interrupt Acknowledge, Input, 
Active Low) 


_ When this line is driven Low, the CRTC examines 
its IEI line to-determine if it has been granted an 
acknowledge by the CPU. 
for normal operations. If INTACK is kept Low or 
floating, the CRTC will not respond to any slave 
accesses nor will it execute DMA transfers. 








IE] (Interrupt. Enable-In, Input, Active High) | 


A Low on IEl during Interrupt Acknowledge 
signifies that a higher priority interrupt on the daisy- 
chain is being acknowledged. IE! being. High 
indicates that the CRTC has highest interrupt 
priority. If the CRTC is not requesting an interrupt, 
IEI ripples to IEO. 


IEO (Interrupt Enable-Out, Output, 
Active High) 


IEO follows IEI during Interrupt Acknowledge if the 
CRTC has not made an interrupt request. IEO Low 
disables lower priority devices from issuing 
interrupt requests. Refer to the Interrupt Section 
for a detailed description of the interrupt protocol. 


HSYNC (Horizontal Sync, Output, Active High) 


HSYNC is an active High output which controls the 
horizontal retrace of the CRT's electron beam. 
This output is held inactive (LOW) when the CRTC 
‘is reset to prevent unknown synchronization of the 
CRT which might cause damage to high bandwidth 
tubes. 


VSYNC (Vertical Sync, Output, Active High) 


INTACK must be High — 


composite of horizontal and vertical blank. This 
output is held High when the CRTC is reset. 


ESYNC (External Syne, Input, Active High) 


This pin is the external synchronization input and 
should be used exclusively for power line 
synchronization. |The ESYNC input cannot 
synchronize two video systems since HSYNC is 
not altered by this signal. This input is enabled by 
setting the External Sync Enable (ES) bit in Mode 
Register 1. | 


RSTT (Test Reset, Input, Active Low) 


RSTT resets the horizontal and vertical internal 
counters, and therefore can be activated to 
synchronize multiple CRTCs. Whenever RSTT 
input goes Low, the following takes effect: 


e HSYNC Low 

e VSYNC Low 

e BLANK High . 
e Mode Register 2:Do.g reset to “0” 
e Horizontal counter reset 


_e Vertical counter reset 


For synchronizing two CRTCs, RSTT should be 
driven synchronously to the Video Timing Clock 


(CLK, or CLKp ). 


RST (Reset, Input, Active Low). 


A Low on this input for at least 5 clock cycles is 
interpreted by the CRTC as a Reset signal. The 
effect of Reset is to drive all CRTC bus signals into 
the high-impedance state and initialize Mode 


Registers 1 and 2. Any Bus Master transaction is 


VSYNC is an active High output which controls the: 


vertical retrace of the CRT's electron beam: This 
output is held Low when the conte is reset to 
prevent ae to the CRT. 


BLANK (Blank Video, Output, Active High) 


BLANK is an active High output. It serves to blank 
out inactive display areas of the CRT. 


It is a. 


terminated and the CRTC will switch to Slave 
Mode. 


CCo_7 (Character Code, Outputs, Active 
High) 


This character port outputs 8 bits of character data 
stored in the Character Code Section of the row 
buffer currently being displayed. The character 
code output can be delayed by 1 or 2 clock 
periods (CLK») in order to allow the attribute bits 
associated with the particular character code to be 
masked and decoded and to generate suitable 
synchronized attribute control (refer to Character 
Period Skew Programming in Mode Register 1). 
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Ro_4 (Scan Line Address, Outputs, 
Active High) 


These outputs provide the binary address of the 


character slice being displayed. Usually, Ro.4 form 
the least significant address portion of a character 
font generator. All outputs are High (1F,4) for scan 
lines outside the range specified by Character 
Start and End (refer Row Redefinition Block 
programming). | : 


APo_19 (Attribute Port, Outputs) 
These 11 lines output the attribute information 


associated with the characters. During HSYNC the 
Row Attribute Word contained in the Row 


Addressing the CRTC: with non-specified pointers 
(OD-OF}, 19-1Fy)-causes no problems. The 
registers can be loaded using a simple software 
nee Starting at 00,4 and enene at 1Fy. 


Register Addressing 


The registers can be accessed only when the 
CRTC is in the Slave Mode. They are addressed in 
a two-step sequence, to simplify slave accesses 


— Viaa demu tiplexed address/data bus: : 


Redefinition Block is output on APo.4 and APg.4o. - 


This word can be stored extemal ey the falling 
edge of HSYNC. — 


- CURSOR (Cursor, Output) 


This pin is the cursor output indicator. Refer to the 
Cursor Section for further information. 


2.3 REGISTER DESCRIPTIONS 


This section provides a brief description of the 
Command; Status, and Display Timing registers in 
the CRTC. Each register description includes the 
register ‘address, the operation of the individual 
register fields and the state of the register alter a 
reset (hardware or software). 


Table 1.is a summary of the CRTC's 22 registers. 
The registers are addressed by an internal pointer 
which is 5 bits wide. The pointer is loaded via 
AD _4 on the external AD ‘bus in Slave Mode write 
cycles with C/D being High. . 


After power-up, the registers should be initialized 
in the following sequence: 


Clear the DE bit of Mode Register 1 by hardware 
reset or by loading the registers 


ee all registers starting with Mode Register 
2 (except Mode ci 1) with the een: 
values 


‘Load Mode Register 1, with the DE-bit set, to 
enable the display 


LoadMode Register2 





e First load_ the internal pointer register . 
asserting CS Low and. C/D. High to indicate a 
command-type cycle. The subsequent Data 
Strobe latches the register address provided by 
the low part of the address/data bus (ADO-AD4). 
This latched register address remains valid until a 
subsequent slave write cycle with cp High 
changes it. 


-Reaccess the CRTC with CS Low and C/D Low 
to read or write the register | pointed by the 
latched address. The data i is strobed in or out by 
the DS signal. 


The CRTC is in Slave Mode if it has not been 
granted control of the bus. After the CRTC has. 
asserted BRQ, it is remains in Slave Mode until it 
receives an bus acknowledge (BAI Low). The CPU 
can access the CRTC registers any time; the CRTC 
places no restrictions on slave accesses. 


CRTC Slave Transfers 


Allslave transfers with the CRTC.can be carried out. 
asynchronously with respect to the CRTC CLK, 
input. Only AS and DS are used to transfer the 
information . | 


The slave transaction typically starts with a pointer 


write, although repetitive accesses to the same - 
CRTC register can be made without any inter- 
vening pointer modification. The transaction is 
timed off the DS signal, since AS may not be pre- 
sent in certain systems. The read transaction com- 
mences from the low going edge of DS. The write 
transaction takes place on the rising edge of DS. 


The AS input is used to drive a transparent latch on 
the CRTC, which is used to capture C/D and CS in 
a multiplexed address/data system. If the system is 
demultiplexed, then AS should be driven Low 


when the CRTC is in the Slave Mode. This drives oo 


the latch permanently transparent, allowing the 
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Table 1 Am8052 Registers 


Pointer Address:(AD4—ADO) 


HEX TYPE ACTIVE BITS REGISTER NAME 

00 R/W 16 Mode 1 

01 R/W 16 Mode 2 

02 R/W 12 Attribute Enable 

03 . W 5 Attribute Redifinition 

04 R/W 8 Top of page soft (High Order). 
05 R/W 16 Top of page soft (Low Order) 
06 R/W 8 Top of window soft (High Order) 
07 R/W 16 Top of window soft (Low Order) 
08 W 16 Attribute Flag 

09 R/W 8 _ Top of page hard (High) 

OA R/W 16 Top of page hard (Low). 

OB R/AW 8 Top of window hard (High) 
oc R/W 16 Top of window hard (Low) 
10 W 16 DMA Burst 

11 W 12 *VSYNC Width/Scan Delay 
12 W 12 “Vertical Active Lines 

13 W 12 “Vertical Total Lines 

14 W 16 *HSYNC/VERTINT 

15 Ww 9 *HDRIVE 

16 W. 9 “H Scan Delay 

17 W 10 *H Total Count 

18 W 10 *H Total Display 


*These registers should be only accessed when display enable ( “DE” bit in 
mode) is reset, since they control the video timing signals __ 
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demultiplexed cs and C/D to pass into the CRTC. 
When the DS goes Low and a read transaction is in 
progress, the CRTC drives the read data onto its 
ADo-AD 45 lines and also drives DTEN Low. This 
enables any off-chip bus transceivers, allowing the 
data to be transmitted to the bus master. When 
the bus master captures the data, it drives the DS 
signal High. This causes the CRTC to cease 
driving its ADp-AD 45 lines and also causes DTEN 
to return High, switching off the bus transceivers. \ 


Register Test > 


When designing register test routine the software 
eee must consider the following poms: 


, @ The Attribute Enable, the Attribute Redefinition, 


‘the DMA Burst, and all video timing registers are 
write only. 


e All reserved fields in the registers should be set 
to zero, however, the state of these fields when 
reading the programmed value back is. undefin- 
ed. For verification purposes these fields must 
be masked out (logical AND) before comparing 

_ the value read back with the value programmed. 


The TOP hard register and the TOP soft register 
use the same _ internal register. Thérefore, 
writing to one register also changes the value of 
the other register. (The CRTC uses internal 
flags to differentiate between write accesses to 
either register). 


If the CRTC is programmed for segmented 
mode, all upper address registers are loaded via 
the upper half of the 16-bit address/data bus (for 
_ linear mode via the lower half of the address/data 
bus). However, the value read back appears on 
the lower half of the address/data bus: (for both 


"segmented and linear mode). 


‘Mode Register 1 


Mode Register 1 contains display and DMA contro! 
bits (Figure 2.4). On reset, all Mode Register 1 bits 
set to “0”. 


Video Timing Clock—CLK1/2 (D45) 


This bit indicates whether CLK; or CLKo drives the 
video timing logic to time the HSYNC (or HDRIVE), 
VSYNC and BLANK outputs. In non-proportional 
spacing applications CLK, is selected, whereas in 
proportional spacing applications CLK» usually 
times the sync signal, since the frequency of CLKo 
is modulated by the character width.. 


CLKy/o =0: Selects CLK» for clocking the sync 
— counters 
CLKy/o =1: Selects CLK, for clocking the sync 


counters 


Character Shift—CSHIFT (D,) 


This bit affects the relative order assigned to the 
two bytes (character codes) fetched from memory 
in aword access (Figure 2.5). 


CSHIFT=0. The LOW byte is displayed first. This 
mode is compatible with iAPX 
microprocessors. 

CSHIFT=1 The HIGH byte is displayed first. This 


mode is compatible with 68000 
microprocessors. 


CSHIFT does not affect 16-bit word data, such as 
addresses, pointers, control information, and 
attributes. 


Invisible Attribute Flag—IAF (D43) 


The charaéter that invoked an attribute is 

loaded into the row buffer, and 
subsequently displayed. The character is 
affected by the attribute word (see option 
1 or 2 in Figure 2.39). 


IAF=0: 


The characters that invoked an attribute 
are not loaded into the row buffer. The 
‘invoked .attribute applies to the next 
_. character. One character word (two 
characters) should contain only one 
Attribute Flag. The second Attribute flag 
within one character word will be 
disregarded. . If two Attribute Flags are 


IAF=1: 


separated by a word boundary (within two 
_ Character words), both will be processed. 


Screen Width Limit—SLIM (D4) 


The SLIM bit controls the number of characters 
loaded in each row buffer to either 132 or 96. This 
can reduce bus overhead when the CRTC row 
length is 96 characters or less. If the CRTC 
reaches the limit of the row buffer (132 characters), 
and more characters are requested, the last, 
132nd, character is repeated. In the 96-character 
mode, the CRTC continues with the random data 
of the row buffers. 


The row buffer size is set to 132 


SLIM=0: 
_ characters. 
SLIM=1: The row buffer size is set to 96 


characters. 


Linear/Segmented Mode—L/S (D44) 


This bit indicates whether the system/display 
memory access is accomplished by addressing it in 
a linear or segmented mode. , | 


The CRITIC is set for segmented 
addressing. The linked-list address 
pointers are two words long. Seven bits 
(Dg.44) of the first word define the 
segment address. The second 16-bit 
word is. the offset address within the 
segment. Any overflow of the 16-bit 
offset address does not carry into the 
upper 7-bit segment address. 


L/S=0: 


The CRTC is set up for a linear addres- 
sing scheme. The most significant byte 
of the 24-bit linear address is stored in 
the lower half of the first word (Do.7). 
The second word holds the remaining 
16 bits. Any overflow of the 16-bit offset 
increments the 8-bit upper address. 


L/S=1: 


During page update cycles the CRTC puts out the 


upper part of the 23/24-bit address on ADo-AD7. 
The user may latch the 7/8-bit address (refer to 


- Section 6). 


Video Blank—VB (D49) 


This bit allows the user to blank the screen while 
making changes in the displayed text or when 
switching the context. The linked-list must, 


_ however, be valid before VB is reset. 
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Figure 2-4 Mode Register 1 
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Figure 2-5 Character Shift - 


VB=0: Normal Operation 
VB=1: The horizontal and vertical sync circuitry 


BLANK output is forced High. DMA 
operation is suspended--normal operation 


resumes when VB=0 and the next vertical 


blanking period occurs. 


Do not use Video Blank (VB-bit in Mode Register °° 


1) to blank the display while the linked-list is being 
_ modified. Instead, synchronize the CPU to the 
Am8052 linked-list scanning via Vertical Interrupts 
(“working on a busy railroad”), or use double- 
buffered linked-lists (the Am8052 interprets one 
while the CPU updates the other). 


lf Video Blank is used, first switch to a linked-list 
defining a blank screen, wait until the Am8052 has 
completely loaded the three top-most rows (all 
three internal row buffers are filled with blanks), 
and then set the Video Blank bit in Mode Register 
1. This procedure ensures that, when the VB-bit is 
reset, no random characters are displayed from VB 
being reset to the beginning of the next frame. 
During this time interval, the Am8052 will display 
the contents of the internal row buffers which were 


preloaded with Blanks. No DMA activity will occur . 


until the beginning of the next frame, when normal 
operation is resumed. 


Character Period Skew—SK,, SK» (Dg, Da) 


The skew bits compensate externally introduced 
clock skew between, character code, attribute 
word, and/or video control signals, e.g. pipelined 
character code path to the Video System 
~ Controller (Am8152A) to relax the required access 
time of the character font generator (see Section 
4)... The skew bits program various delays ‘in 
number of character clock cycles applied to the 


VSYNC, HSYNC, and BLANK signals with respect 


and outputs operate normally and the - 


DH=0: 


DH=1: 


to character code: output. The attributes and 
cursor outputs can also be selectively delayed by 


SKg and SK;. The following combinations are 
piogrannaol | | 
Bit Settings Signal Skew (# of CLK2 Cycles) 


HSYNC,VSYNC APO-AP10 CC0-CC7 


SKi SKO & BLANK -& CURSOR & RO-R4 
0 0 0 0 0 
oO 1 1 0 0 
1 0 2 1 0 
1 1 1 1 0 


Horizontal output Select-HOS (D7) 


HOS=0: The HSYNC/HDRIVE output pin outputs 
the horizontal sync timing as programmed in ‘the 
HSYNC Register (8- -bit counter). 


HOS=1:The HSYNC/HDRIVE output pin outputs _ 
the horizontal drive timing as programmed in the 
HDRIVE Register (9-bit counter). 


Wait State—WS>5, WS (Dg; Ds) 


These bits indicate the number of Wait states 
inserted for each DMA cycle. These Wait states 
are in addition to any externally applied Wait states. 
When the CRTC is in Slave Mode, these bits are 
ignored. 


WAIT STATE 


WS1 WSO 
0 0 No Wait State 

0 1 DS stretched by one clock 
1 0 DS stretched by two clocks 
1 1 


Reserved 


- Display Hidden—DH (Dg) 


Applies only to characters which have the Ignore 
attribute bit set (“1”) in the attribute word 
associated with this character. 


The Ignore attribute is active; characters 
with the Ignore attribute set (“1”) are not 
loaded into the row- buffer. 


Those characters are treated as 
displayable information (see Section 2.6). 


Interlace—ly, Ip (D3, Do) 


Control the timing. of non-interlaced, interlaced, 


repeat field interface videa to support different 


N\ 
E 


2-10 


CRTs (see Section 2.10). 


MODE OF OPERATION 
0 0 Non- ineiseea Video 
0 1 Reserved 
1 O Repeat Field Interlace (RFI) . 
1 1 Interlaced’ Video 


External Sync Enable—ES (Dj) 


Enables the ESYNC 
synchronization. 


input for power line 


ES=0: ESYNC inputis ignored. 
- ES=1: A rising edge at the ESYNC input during a 
vertical-retrace active period (even frame 
only in interlaced mode) causes the 
HSYNC output to go (or remain) active fora 
full horizontal retrace period. The VSYNC 
active period is stretched, even when 
register timing signifies an end to vertical 
retrace, until an ESYNC falling edge 
occurs. 


Display Enable—DE (Dp) 


DE=0: VSYNC, HSYNC’ outputs are_ inactive 
(LOW) and the BLANK ‘output is held 
active (HIGH). DMA operation is disabled. 
The DE bit is reset by a hardware reset 
(RST=Low) or may be reset by the host 
processor (software reset). DE=0 resets 
the scroll logic to the non-scrolling state. 

DE=1: The CRTC display operation is enabled. 

DE can be set only by a host processor 
“access of Mode Register 1. 
DE=1 causes the VSYNC, HSYNC, and 
BLANK outputs to become active and the 
DMA controller on board the CRTC event- 
ually requests access to the system bus. 


Mode Register 2: 

Mode Register 2 contains the primary control bits 
for the interrupt control logic and cursor definition 
(Figure 2.6). 


Upon reset, all Mode Register 2 bits are reset to 
zero. 


Cursor Enable—CUE (D4s5) 


CUE=0: The CRTC does not output any XY 
cursor information. 
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Setting the © 


CUE=1: The XY: Cursor Register is enabled. 
CRTC outputs cursor at the character 
position defined by the XY Cursor 


‘Register (see Main Definition Block). 


Attribute Cursor Mask—ACM4, ACMg (D43, D42) 
Cursor Mask—XYCMy4, XYCMp (DQ, Dg) 


The cursor mask field (D;3, Dy2, D490, Dg) defines 
the type of cursor that is generated when.a cursor 
is required. This field is divided into two parts: 


Di3 Dy CURSOR ATTRIBUTE 
DEFINITION 
0 Cursor Pin Whole 
1 Cursor Pin Part 
0 Underline 
1 Reverse 
D410 Do XY CURSOR DEFINITION 
0 ‘Cursor Pin Whole 
1 Cursor Pin Part 
0 Underline 
1 Reverse 


“Cursor Pin Whole” means that the cursor signal 
will appear on the cursor pin for every scan line of 
that character position (TSLC). CURS and CURE 


_ of the Row Redefinition Block are ignored. 


“Cursor Pin Part” means that the cursor signal will 
appear on the cursor pin for those scan lines 
specified in the Row Redefinition Block (CURS 
and CURE). | 


“Underline” (BLOB) means that the cursor signal 
will appear on the underline pin (AP1) for the scan 
lines specified in the Row Redefinition Block 
(CURS and CURE). 


“Reverse” (part) means that the cursor signal will 
appear on the reverse pin (AP5) for the scan lines 
specified in the Row Redefinition Block (CURS 
and CURE). | 


Scroll In Progress—SIP (Dg) 


SIP is a status bit that is set/reset by the CRTC 
smooth scroll control logic. 


SIP=0: The CRTC is not saenly setelilig: 


SIP=1: The CRTC is scrolling either window or 


background. 


Ses 


Disable Lower Chain—DLC (D7) __ 

pLc= 0: IEO operates normally. 

DLC 1: The Interrupt Enable Out (IEO) output of 
the device is forced Low, disabling 

__ interrupts from all lower priority devices on 

the daisy-chain. | 

No Vector—NV (Dg) 

~ NV=0: 


The CRTC outputs the interrupt vector 
programmed in the Main Definition Block. 
(See the section on Main Definition Block 
and Interrupt.) 

During an Interrupt Acknowledge cycle, 


NV=1: 
: the interrupt vector is inhibited. The 
vector can, therefore, be provided by 
external hardware if necessary. It has no 
effect on the: setting of the Interrupt 
Under Service bits. 


Interrupt Under Service Vertical 
Event—IUSV (Ds) , 


This status bit is automatically set if IPV (Interrupt 


Pending Vertical Event) is the highest priority | 


interrupt request pending when an_ Interrupt 
Acknowledge sequence takes place. It can also 
be set’or cleared directly by CPU command. While 
the IUSV is set, internal and external daisy-chains 
prevent the same and lower priority sources of 
interrupt from requesting interrupts. The IUSV can 
be cleared to “0” only by CPU command. For 
details of Interrupt Operation, see Section 2.7. 


Interrupt Enable Vertical Event—IEV (D4) 


This bit enables or disables the vertical event 
interrupt logic. 


IEV = i The Vertical Interrupt. is disabled. The 
CRTC: does not request an interrupt at 
vertical event nor respond to an interrupt 
acknowledge. 


~ 


IEV=1: The Vertical Interrupt is snabied 

Interrupt Enable (IEV) does not affect the normal 
operation of Interrupt Pending (IPV) and: Interrupt 
Under Service (IUSV). If IEV disables the interrupt 
(IEV=0), then setting the Interrupt Pending Bit 
(IPV) does not activate the Interrupt Request Line. 
lf IEV=0, then a “1” in IUSV affects the interrupt 
daisy-chain; all lower priority devices are disabled. 


the corresponding pins will be active. 
attributes are independent of the Ro-R,4 outputs. 


Interrupt Pending Vertical Event—IPV (D3) 


IPV is a status bit which, when set to “1,” indicates 


that a vertical event:has occurred and CPU service | 


is required. A vertical event occurs when the 


CRTC internal load row counter matches the — 
_ VERTINT value loaded in the HSYNC/VERTINT 


Register. | This interrupt provides’ real-time 


positional information. This is the lowest priority IP 
‘bit inthe CRTC. The IPV can be cleared se bya 
_ CPUcommand. 


Interrupt Under Service ‘ 


Smooth-Scroll—lUSS (D9) 


Same as vertical event but applies for smooth- 
scroll event. 


Interrupt Enable Smooth-Scroll—lES (Dj) 


This bit enables or disables the smooth-scroll's 


- interruptlogic. Same as vertical event. 


ntereapE Pending Smooth-Scroll—IPS (Do) 


IPS is a status bit which, when set, indicates that a 
smooth-scroll event requires ‘CPU. intervention. 


This is the highest priority IP bit. 


Attribute Port Enable Register 


Bits Dg through Dy in the Attribute Port Enable 
Register allow the corresponding _ attribute 


_ information to be output on the matching attribute 


pin (Figure 2.7). = When reset (“0”), the 
corresponding attribute pin is driven Low. When 
set, the corresponding pin outputs attribute 
information. Bits Dg and Dz, of this word affect the 


subscript and superscript attribute pin operation. If 


these bits are enabled for subscript or superscript, 
These 


The user can thus address a: separate character 
font generator for subscript or superscript display, 
e.g. a smaller font. The CURSOR PIN ENABLE 
(CPE, Dy) bit ofthis register enables/disables 


-only the cursor pin. When disabled, neither the X- 
Y cursor nor the attribute cursor is output through : 
_ the cursor pin epee ‘Low). 


Attribute Cursor Enable—ACE (D4) © 


The Attribute Cursor Enable Register enables/ 
disables the path between attribute cursor and 


Hl 
rs 


Eb-¢ 


CURSOR 
ENABLE (CUE) 


RESERVED 


ATTRIBUTE 
CURSOR MASK 


RESERVED 


X-Y CURSOR 
MASK 


 SCROLLIN- 
PROGRESS (SIP) 


Yy WRITE: 


Yy READ: X 


ADDRESS: 000018, 01H (READ/WRITE) 


Figure 2-6 Mode Register 2 


INTERRUPT PENDING SOFTSCROLL (IPS) - 
INTERRUPT ENABLE SOFTSCROLL (ES) 
cieARUE UNDER SERVICE SOFTSCROL- (IUSS) 
INTERRUPT PENDING VERTICAL (IPV) — 
INTERRUPT ENABLE VERTICAL (IEV) 


INTERRUPT UNDER SERVICE VERTICAL (IUSV) 


fet 


NO VECTOR (NV) 


DISABLE LOWER CHAIN (DLC) 


03901A-07 


cursor output pin. 


- Attribute Redefinition Register 


The Attribute Redefinition Register allows the user 
to redefine some of the internally processed © 


attributes, which can, therefore, be treated as user- 

definables (Figure 2.8). A “0” keeps normal 
‘attribute operation; a “1” directly outputs the 
attribute state to its corresponding pin without ay 
internal ploces=ig of the attributes. . 


Top of Page/Top of Window Réaisier | 


Figures 2.9 and 2.10 show the format of these 
registers. 


The Top Of Page and Top Of Window Registers 
point to the Main Definition Block and Window 
Definition Block respectively; these blocks contain 
the primary information concerning _ the 
background display and the window display. 


Two different forms of Top of Page/Window 
Register writes are available: hard and soft. “Top of 
Page/Window Soft” is used to trigger the smooth- 
scroll and to interact with the smooth-scroll 
controller (See section on smooth-scroll). “Top of 
Page/Window Hard” has no effect on the smooth- 
scroll procedure and should be used for link 
manipulations that do not involve smooth-scroll. te 
the .Top of Window Register contains “0,” 
window is displayed on the screen. 


Top Of — Page/Window Hard and. Top Of 
Page/Window Soft access the same _ internal 
register. When loading Top Of Page/Window Hard 
the information the value gets strobed into the 
visible register and, in addition, gets immediately 
transferred to the DMA unit. When loading the 
Top Of Page/Window Soft register the value gets 
only loaded into this visible register. The transfer 
to the DMA unit is delayed. until the CRTC re-loads 
the hard register with the value stored in the soft 


Tn 


register (only for smooth scrolling being activated). 
This means, that loading the hard register 


_ overwrites the contents of the soft register, but 


loading the soft register does not over-write the 
contents of the hard register. ° 


Attribute Flag Register 


The Attribute Flag Register defines the bit pattern 


~ that will invoke an attribute word from the attribute 


segment (Figure 2.11). 


This 16-bit register is divided into two sections, 
Mask and Value.. Each 8-bit character code loaded 
from memory, is. analyzed, to determine whether _ 
this character is an attribute invoking character. 
Any binary group of character can be defined as 
attribute invoking characters. The analysis is 
based on a mask operation (using Mask) and a 
comparison of the remaining pattern with Value. If — 
the remaining pattern and the Value are equal, this 
character is an attribute word invoking character. In 


this manner, it is possible to define a group of 1, 2, 


4, 8, ..., 256 character codes as attribute invoking 
character codes. 


The attribute fetch mechanism can be ica 
turned off (0 attribute invoking character codes) by 
setting the least significant Mask-bit (D8) to “0”, 
and the corresponding value-bit (Dp to “1”, e.g. 


loading 0001H into the Attribute Flag Register. 


(This feature is only available on devices with 
copyright date of 1985 or later). 


| Mask (7-0) (Dy 5—Dg) 


The Mask Register defines which bits of the 8-bit 
character field will be compared against the Value 
Register to determine if the character invokes an 
attribute word. A “0” in bit position N of the mask 
indicates that character bit N is a “don't care” in the 
value comparison. A “1” in bit position N of the 
Mask Register indicates that character bit N should 
be compared against value bit N. 


- Page And Window Registers 


# Of Active Bits — 





Register 


LINEAR 
TopOfPage Soft(Hl) ~= = 8 
Top Of Page Soft (LO) 16. 
Top Of Window Soft (HI) 8 
Top Of Window Soft (LO) 16 
Top Of Page Hard (HI) 8 
Top Of Page Hard (LO) 16 
Top Of Window Hard (HI). 8 


Top Of Window Hard (LO) 16 


Address 
SEG. . BINARY . HEX ~~ TYPE 
7 _ 00100 04 R/W 
16 00101 05 R/W 
7 00110 06 R/W 
16 00111 07 R/W 
, i _ 01001 09 R/V 
16 * 01010 OA R/W 
7 01011 0B R/W 
16 . 01100  0C R/W 
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ADDRESS: 00010p, 024 (WRITE ONLY) 


Dis : Do 
GZ Vy Y 
ATTRIBUTE CURSOR ENABLE (ACE) : BLINK (BL) 
CURSOR PIN ENABLE (CPE) ; UNDERLINE (UND) 
| USER DEFINED (UD) : | : : : SHIFTED UNDERLINE (SUND) 

USER DEFINED (UD) — | | . SUBSCRIPT (SUBS) 

USER DEFINED up) = . . —— SUPERSCRIPT (SUPS) 

‘USER DEFINED (UD) - - , — REVERSE (REV) 


HIGHLIGHT (HL): 


03901A-08 


ae . Figure 2-7 Attribute Port Enable Register 


WRITE: 0 ; : 
READ: X | 


91-2 


D ADDRESS: OOOHE: 03H (WRITE ONLY) 
15 


(ZCI == 


DISABLE BLINK (DBLK) _ 
DISABLE UNDERLINE (DUND) 

DISABLE SHIFTED UNDERLINE (DSUND) 
DISABLE SUBSCRIPT (DSB) 


DISABLE SUPERSCRIPT (DSP) 
03901A-09 


Figure 2-8 Attribute Redefinition Register 


i 


Value (7-0) (D7—Dg) 


The Value. Register holds up to eight bits of 
information for comparison with the fetched 
character, to determine if an attribute should be 
invoked. Note that only those bits of the Value 
Register which have the corresponding bits of the 
Mask Register set to “1” are compared against the 
character code. Value bits with corresponding 
Mask bits set to “0” should be set also to “0,” 
unless the attribute fetch mechanism is disabled. 


Example 1: 

All control characters (character code within 00, 
and 1F14) invoke an attribute. To display these 
control ‘characters IAF=0; not to display these 
characters IAF=1 (see Mode Register 1). All 
control characters are of the form: 


Control Characters: 


0 0 0 X X X X X 
So the mask is: 1 1 1.00 0 0 0 
and the value is: 0000000 0 
(X is “Don't Care”) 
Dis Dg D7 


So the Attribute Flag Register contents are: - 


1110000000000000 (E000,)). 


Example 2 


One specific flag (7F,4) invokes an attribute. In this 
case, all bits of the character code are compared to 


the Value. 

Flagcharacte: 0 1 1 1 1 1 1 1° (7FH) 
. Sothemaskis: 1 1 11141 41 =41 
andthevalueiss O 1 1 1 1 #1 #4 #1 = (7Fy) 


Hence the Attribute Flag Register contains: 


11111111011111114(FF7Fy). | 


Burst Register 

The Burst Register (Figure 2.12) specifies the bus 
occupancy of the CRTC DMA unit. Burst Count 
determines the maximum burst length in Number 


Do 


15 


oO 


D 


°o 


LOWER ADDRESS 


03901A-9 









) 


Figure 2-9 Top of Page and Tse of Window Pointer Formats with L/S =0 
Dis r : De D7 , Do 
WMMMMMMEEEA_ OO | 
"Dis : ‘Do 
03901A-10 
Figure 2-10 Top of Page and Top of Window Pointer Formats with L/S = 1 
AebReeS 01000B, 08H (WRITE ONLY) 
Dis Dg D7 Do 
| _ ATTRIBUTE FETCH 
O3901A-11 | 0 0 NORMAL OPERATION 
| 0 1 ATTRIBUTE FETCH DISABLE 
Figure 2-11 Attribute Flag Register 1 xX NORMAL OPERATION 
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of DMA transfer cycles. Burst Space determines - 
the minimum release time between two bursts. 
This guarantees real-time responses of the CPU to. 


other peripherals. Burst Count and Burst Space 
must be programmed with reasonable values that 
allow the CRTC to fetch all data needed for a flicker- 
free screen. 


Burst Space—BS7_p (D45~-Dg) 


This 8-bit value specifies the number of 15 system 
clock cycle (CLK;) periods before another bus 
request will be issued, after the CRTC has 
released the bus due to burst count out. If this 
value is set to “0” the CRTC occupies the bus as 
long as necessary to accomplish its DMA activity, 
e.g. fetching all information related to a particular 
character row. If a DMA burst is interrupted due to 
DMA preemption or “end of row”, the next burst 
completes the remaining burst count. This means, 


that the first DMA burst loading ¢ a row usually is ~ 


enoder nan programmed. 


Burst Count—BCp_7 (D7—Do) 


The CRTC executes Burst Count-1 DMA transfer 
cycles per burst. If BCo_7 is set to “0,” no DMA 
activity will occur. If BCo_7 is set to “1,” the CRTC 
only requests the bus and after granting the bus, 
immediately releases the bus, because the first 
cycle is an Idle DMA Cycle (no bus activity for three 
clocks). So, the minimum value for normal 
operation is “2.” | 


Video Timing Registers: 


These registers are initialized before setting the 
DE-bit in Mode Register 1. They hold the 


parameters needed to generate vertical and 


horizontal syne and blank (VSYNC, HSYNC, and 

BLANK). These signals are put out on the like- 

named pins of the CRTC and are used by the 

- “Am8152A.. BLANK combines horizontal and 
vertical blank (HBLANK and VBLANK). 


Horizontal timing parameters are expressed in 
number of bus or character clock cycles (CLK y/o bit © 


of Mode Register 1). Vertical timing parameters are 
expressed in number of scan nee (HSYNC 
cycles). / 24 | | 


HSYNC (8-bit counter and HDRIVE (2-bit counter) 
represent two ways of specifying the signal 
waveform on the HSYNC. output pin. With the 
exception of the width, these two counters are 
functionally identical. 


In the following discussion a frame consists of one 
field in non-interlaced mode and two fields (even © 
and odd) in RFI and Video Interlace modes. 
peees 2.13 and 2.14 show the vertical timing. 


Vertical Sync Width/Vertical Scan Delay 
Register 


- Figure 2.15 shows the register format. 


Dy5-Di0 NOT USED 
Dy1—-Dg VERTICAL SCAN DELAY (VSD) 
Ds-Do VERTICAL SYNC WIDTH (VSW)_ 


Vertical Scan Delay—VSD (D44—Dg) 


The Vertical Scan Delay field specifies the vertical 
blank time after the falling edge of VSYNC, thus 
defining the top border width, or vertical back 
porch, of the screen. VSD is expressed in scan- 
line units. When in non-interlaced mode, the 
actual vertical scan delay is equal to VSD + 1 scan 
lines. When in video interlace mode or Repeat 
Field Interlace (RFI) mode, the actual vertical scan 
delay is equal to [(VSD + 1) / 2 lines]. In this case, | 
VSD must be odd. 


Vertical Sync Width—VSW (Ds—Dp) 


The Vertical Syne Width determines the width of 


the active-High pulse signal which is sent through 
VSYNC output to the CRT monitor in order to 
synchronize it vertically. 


VSW is. expressed in scan line units. In non- 
interlaced mode, the actual vertical sync width is 


ADDRESS: 10000g, 10H (WRITE ONLY) 


Dis 


Dg D7~ : Do 


BURST SPACE (7-0) ; BURST COUNT (7-0) 


3 | 
" 03901A-13 | 


Figure 2-12 Burst Register . \ 
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equal to VSW + 1 scaniines. Vertical Active Lines Register 


In interlaced and RFI mode, the actual vertical sync 7 
is equal to [(VSW+1)/2 lines]. In this case, VSW = D45-Dy9 NOTUSED | 
must be odd. Dy4-Do : VERTICAL ACTIVE LINES (VAL). 





VSYNC 
(EXTERNAL) 


VBLANK 
(INTERNAL) 

















03901A-17 
| _ Figure 2-13 Non-Interlaced Video Vertical Syne Timing 
vSw +1 VTOT +1 vVSW +1 VTOT +1 
. 2 2 2. 
(EXTERNAL (EVEN FIELD) (ODD FIELD) 















\*— VSD +1 
VBLANK QF 
(INTERNAL) 
peas Soe WAL en ee 
2 2 
VSD, VSW, VAL MUST BE ODD 
VTOT MUST BE EVEN 
03901A-18 
Figure 2-14 RFI and Video Interlace Vertical Syne Timing 
<< HTC + 1—_______> 
HSYNC +1 
: [~~ HDRIVE +1 
HSYNC 
(EXTERNAL) 
HBLANK 
(INTERNAL) 
ot <—_———— HTD + 1 ————+<—IIN 17 CLK2 —>| 
INTERLACED VIDEO: HTC MUST BE EVEN ° 
03901A-19 
Figure 2-14a Horizontal Syne Timing 
ADDRESS: 10001, 414 (WRITE.ONLY) 
Dis "Diz Day hs De Ds | Do 
03901A-14 


Figure 2-15 Vertical Sync Width/Vertical Scan Delay Register 


} 
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This 12-bit field defines the. number ‘of scan lines 
between the.end of a vertical sync pulse and the 
start of vertical blanking Figure 2. 16). 


When in non-interldtied: raid! the actual scan- fing 
number between the falling edge of VSYNC and 
the rising edge of VBLANK is equal to VAL+1. 
The active video area height on the screen is then 
(VAL+1) —(VSD+1) = VAL— VSD scan lines. 


When in video interlace or RFI mode, the actual 
scan-line number between VSYNC and VBLANK 


‘is equal to [(VAL + 1)/ 2]. In this case VAL must be 


odd. The active video area height.on the screen is 
then given by [(VAL + 1) / 2] - [(VSD +1)/2]= 
[(VAL — VSD) / 2 scan lines]. This is true for the 
odd and even field. , 


Vertical Total Lines Register 


NOT USED 
VERTICAL TOTAL LINES (VTOT) — 


Dy5-D42). 
D44-Do 


The. Vertical Total Lines’ Register defines the total 
number of scan lines per field minus the vertical 
sync width (Figure 2.17). 


: : 
In non-interlaced mode; the actual scan° 
number between VSYNC ang next VSYNG ie 
a : : 
In interlaced or RFI mode, this timing is [WTOTs 
1)/2], and VTOT must be even (half scan line 
between even and odd fields). — 


‘Horizontal Syne and Vertical Interrupt 
Row megisier 
Figure 2. 18 showe the ete icinee 


Di5-Dp 
D7—-Do 


VERTICAL INTERRUPT ROW (VERTINT) 
HORIZONTAL SYNC WIDTH (HSYNC) 


Vertical Interrupt RoW—VERTINT (Dg-D45) 


This field determines the row number which, after | 


being completely loaded by DMA, causes an 
interrupt. If VERTINT is set to “0,” the vertical 
interrupt occurs after the rising edge of VBLANK, 


before the CRTC starts loading the Main Definition - 


Block. If VERTINT is set to “1” (“n”), the vertical 
interrupt is generated right after the first (nth): row 
has been loaded. : 


ADDRESS: 10010g, 124 (WRITE ONLY) 


— Dis Di2 Dai 


ADDRESS: 1001 


Dis Di2 D14 


VERTINT 


| 7 _ | 03901A-15 
Figure 2-16 Vertical Active Lines Register 
| e 
1, 184 (WRITE ONLY) | ys 
WMMMa_ 
| , | 03901A-16 
Figure 2-17 Vertical Total Lines Register 
ADDRESS: 101008, 14H ane ONLY) 
De D7 Do 
Lo 03901A-20 


Figure 2-18 Horizontal Sync W 


. 
! ; 


idth/Vertical Interrupt Row Register 
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line: 


\ 


Horizontal Syne Width—HSYNC (Do-D7) 


This field determines the width of the horizontal 
sync (active High) pulse in video clock units (CLK; 
or CLK» depending upon CLKy,o bit in Mode 
Register 1), provided that HSYNC is selected 
(HOS=0 in Mode Register 1). These pulses are 
output on the HSYNC pin. The actual width of the 
signal is HSYNC + 1 clock periods. 


Horizontal Drive Register 


Reserved 
HORIZONTAL DRIVE (HDRV) 


D45-Dg 
Dg-Do 


This register determines the width of HSYNC if 
horizontal drive is selected (HOS=1 in Mode 
Register 1). The actual width of HSYNC is HDRV + 
1 clock periods. This is also an output on the 
HSYNC pin. (See Figure 2.19.) 


Horizontal Scan Delay Register 


Reserved 
HORIZONTAL SCAN DELAY (HSD) 


D15-Dg 
Dg-Do 


The Horizontal Scan Delay Register determines 
the interval from rising edge of HSYNC to the 
falling edge of HBLANK, which. defines the left 
border (back porch) on the screen. The actual 


‘interval value is HSD + 1 clock periods. 


(See 
Figure 2.20.) 


Horizontal Total Count Register 


~ Reserved 
HORIZONTAL TOTAL COUNT (HTC) 


D15-D10 
Do-Do 


This register determines the period of the HSYNC 
waveform. The period is HTC + 1 clock periods. In 
Interlaced mode, HTC must be even. (See Figure 
2.21.) | 


Horizontal Total Display Register 


Reserved 
HORIZONTAL TOTAL DISPLAY (HTD) 


Dy45-D10 
Dog-D0o 


This register determines the interval from the rising . 
edge of HSYNC to the rising edge of HBLANK. 
HTD must be odd in interlaced mode. The actual 
interval value is HTD + 1 clock periods. (See 
Figure 2.22.) 


| Video Timing Programming Example 


The following example outlines the computation of. 
the display timing parameters for a 30 row by 80 
character display, each character embedded in a 8 


ADDRESS: 101018, 15 (WRITE ONLY) 


Dis ‘Dg Dg 


Waa... | ° 


' 


03901A-21 


Do 


' Figure 2-19 Horizontal Drive Register. 


ADDRESS: 101108, 16H (WRITE ONLY) 


Dis Ds Ds 


, 2 Do 


03901A-22 


Figure 2-20 Horizontal Scan Delay Register 
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x 17 (Hx V) matrix, with a refresh rate of 50 Hz in 
_ non-interlaced mode using a CRT monitor with the 
following characteristics: 


Display Resolution: 


720 pixels horizontal 
512 lines vertical 
Scanning frequency: 28-36 kHz horizontal . 
| 45-65 Hz vertical 
_ Horizontal retrace time: | 6microseconds 
Vertical retrace time: 600 microseconds 
Horizontal SYNC width: § 3 microseconds 


Computation: | 


_ The appropriate character clock and the timing | 


parameters for the video timing registers must be 
calculated. 


_ The active display size is given by: 


Horizontal: 80 characters + 8 pixels/char. 
= 640 pixels 
Vertical: 30 rows « 17 scan lines/row 


—=510scanlines — 


Assuming a 20% blank border vertically, the 510 
scan lines occupy 80% of frame time. At a frame 
rate of 50 Hz, the horizontal frequency can be 
‘calculated as: 


510 scan lines /0.80 
= 637 scan lines 
637 - 50 Hz.= 31.85 kHz 


Total Scan Lines/frame: 


Horizontal Frequency: 


Assuming a 20% blank horizontally, the 80 
characters occupy 80% of row time. Character 


clock is therefore 100 times the horizontal 
frequency (3.185 MHz). Each character occupies 
1/100 of the row. : 


Let us use a more. convenient frequency, 3.00 
MHz, as character clock and re-calculate the 


parameters: 

Characterclock - 3.00 MHz 

Horizontal frequency 30 KHz | 

Scan line time 33.3 microseconds 

Frame time 637 * 33.3 microseconds 
=21.2ms 

Frame rate 


47 Hz 


Now the registers’ contents can be calculated: 


Mode Register 1 


The character clock is 3 MHz; the CLK; 9 bit is set 
to “OQ” to select CLK for the frame aiming 
generation. 


With only 80 characters/row, we select “SLIM=1” 
which reduces the row buffer length to 96 
characters. 


The monitor accepts an HSYNC signal: “HOS=0”: 
Non-interlaced made yields in: “14-0, ”“19=0.” 


External sync Enable is set to ‘0, ” since we do not 
need to be synchronized to another signal. 


Display Enable should be set to “1,” once the 
other registers are set.to the proper values. 


Vertical sync width: The vertical sync width is equal 
to the specified horizontal retrace time of the 
monitor. 

VSW +1 = 600 microseconds 

VSW+1 = 600/33.3 = 18 scan lines 


‘ ADDRESS: 101118, 17H (WRITE ONLY) . ' 


Dis Dio Do 


| 03901A-23 — 
. ; _ Figure 2-21 Horizontal Total Count Register | 
ADDRESS: 110008, 18H (WRITE ONLY) 
Dis Dio Dg ; ae 
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Figure 2-22 Horizontal Total Display Register 
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VSW = 17,9 =11p 

Vertical Total Line Register (VTOT): The number of 
vertical total lines equals to the number of scan 
_ lines (637) minus the Vertical Sync Width (VSW). 
. (see Figure 2.13) 


NTOT +1 = 637-—(VSW +1) =619 
VTOT = = 61849 = 26Ay) 
Vertical Active Line Register 


This value is the total scan line number of the 
screen minus the number of scan lines contained 


in the bottom border area (10% of the screen 


height): 
VAL+1 =0.9°(VIOT +1) 
= 0.9°619 =557 scanlines 
VAL = 59649 =22Cy 


Vertical Total Line Register: 


VTOT +1 = 637—(VSW + 1) =619 
VTOT == 61849 =26AH 


Vertical Sync Width/Vertical Scan Delay 
Register 


Vertical Syne Width: h(vsW)- =11}) (as computed 
above) 


Vertical Scan Delay (VSD): (see Figure 2.13) 


VSD +1 = (VAL+1)-510 
VSD = 4649 =2Ey 

VSD shifted six bits left to fit the field inthe 
register. 

VSDghift = B8OH 

VSW/VSD Register = VSD gsnift + VSW 


= OB80y +11, =O0B91y) 


Horizontal Sync and Vertical Interrupt 
Row Register 


VERTINT is set to “O” in this example. 
HSYNC +1 = 3microseconds = 3°3. 
= 9character clocks 
HSYNC = 849 = 8y 


Horizontal Drive Register 


This is a “don't care” since HOS=0. 


(HSYNC 
selected) | 


Horizontal Scan Delay Register 


HSD+1 = (HSYNC +1) + oye to HBLANK 
delay) 
HSD+1 = (HSYNC +1) + HTC + 1—(HSYNC +1) 
| — number of displayed characters}/2 
~HSD+1~— = (100-—9-80)/2+9= 15 character 
clocks 
HSD = 1449 =0Ey 


Horizontal Total Count Register: 
HTC +1 = 100 character clocks 
HTC = 99749 =63y 


‘ 


Horizontal Total Display. Register: 


HTD +1 = numberof characters displayed + 
(HSD +1) 
HTD+1 = 80415 


‘HTD = 9449 =5Ey 


2.4 DMA OPERATIONS 


Once the CRTC has been initialized and the 
various registers programmed to meet the 
application's needs, the CRTC is responsible for 
initiating System Bus Requests to fetch Control 
Data and Display Data from memory and to transfer 
them into its on-board registers and row buffers, 
respectively. The CRTC requests the bus after the 
DE-bit in Mode Register 1 has been set to a “1.” 


DMA Signals and Protocol 


Before the CRTC can-perform a DMA operation, it 
must gain control of the System Bus. The BRQ, 
BAI and BAO interface pins constitute the basic 
interface between the CRITIC and other devices 
capable of bus arbitration (e.g. microprocessors 
and other DMA devices). Whenever the CRTC | 
requests bus control, the operation is executed © 
according to the flowchart in Figure 2.23. The 
DMA sequence can described as the orang: 


1. Ifthe CRTC needs to perform a DMA access, it 
triggers the bus request operation. 


_ 2. First, it checks whether the bus is being used 


by another peripheral device by polling the 
BRQ line. until it is High. Then, it waits for the. 

_ CPU to gain bus control. This is indicated 
through the daisy-chain (BAI=High). 


3. At that time the bus is under control of the 
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NORMAL DAISY 
CHAIN OPERATION 
(BAO = BAl) 





CRTC 
DMA REQUEST 
? 


YES 

















TRANSFER 
COMPLETE 


WAIT 
3 CLK1 PERIODS 





DMA ACTIVATED 


. START OF BUS REQUEST OPERATION 


POLLING FOR BUS 

RELEASE FROM BUS-MASTER (IF PRESENT) 
AND FOR BUS RELEASE ACKNOWLEDGE 
FROM CPU 


ACTIVATING BUS REQUEST LINE 
AND DAISY CHAIN LOCK 


WAITING FOR BUS REQUEST 
ACKNOWLEDGE FROM CPU 


DMA TRANSFER OPERATION 


DMA TRANSFER INTERRUPTION? 


BUS RELEASE AT END 
OF DMA TRANSFER 


to 


TEMPORARY 
BUS RELEASE 


Figure 2-23 DMA Bus Request Flow Chart 
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CPU, and the CRTC can issue its request by 


pulling BRQ Low. It also inhibits Bus 
Acknowledge from propagating to lower priority 
devices (in the lower part of the daisy-chain) by 
pulling BAO High; this avoids granting the Bus 


to lower priority devices which may have issued . 


BRQ at the same time as the CRTC. 


Before initiating any DMA transfer, the CRTC 
waits for bus request acknowledge from the 
CPU by polling its BAI input. | 


The CRTC now acts as Bus Master and 
__ performs the required transfers. 


The CRTC DMA transfer can be temporarily 

' interrupted by removing Bus Acknowledge In 
(BAl=High)—external bus preemption. The 
CRTC requires that BAI is active for a minimum 
of four clocks. If the CRTC is preempted within 
the first four clocks, the CRTC might not detect 
the bus acknowledge causing the CRIC to 
keep waiting for BAl Low. The result is that the 
bus arbitration locks up. To overcome this lock 
condition either the minimum width of BAI must 
be guaranteed or the external arbiter must be 

able to recover from this lock condition (detect 
of lock, then temporary release the preempting 
signal). | 


.- The CRTC terminates the transfer when it has 
filled the internal row buffers or when the burst 
count reaches zero. The bus is released 
(BRQ=High) and bus acknowledge ripples 
through (BAO=BAI). Then either the CPU ora 
lower priority device on the daisy chain can gain 





DTC 
DEVICE Y 


DEVICE X 
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control of the bus. The lower priority device 
might have pulled BRQ Low concurrently with 
the CRTC and is waiting for ca Low to start its 
activity. 


. The CRTC | DMA transfer is misnucied by 
removing BAI. The CRTC finishes. the current 
bus cycle and releases the bus for three 
system clocks (BRQ=High, BAO=BAI). Then it 
tries to resume DMA activity and. continues 
DMA operations and burst count from where it 
was interrupted. 


Buffering BRQ 


When BRQ needs to be buffered (for example, to 
drive a system backplane), a specific bidirectional 
interface buffer must be used. Such an interface 
and its implementation is described below: 


Detail “A” in Figure 2.24 shows the BRQ buffer 
logic. Note that the “buffer” and the “OR gate” are 
both open collector (OC) devices. When the 


. backplane BRQ is High, and no DMA AA device 


requested the bus, then all BAI's and BAO's are 
High, hence X3 and X2 are High ang X1 is driven 


~ High. 


BACKPLANE BRO 





lf device X requests the bus, it locks BAO High and 
pulls X1 Low to initiate a bus request, which in turn 
pulls X3 Low since X2 is High (BAO=High). The 
detail “A” logic is then locked into this state 
through the open collector buffer, as the CPU and 
the other detail “A” interfaces on the bus. All 
these interfaces are locked the same: way as the 


DETAIL “A” 


RQ 





DEVICE Z 


Figure 2-24 System with Multiple DMA Devices | 
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|. buffer. | 


requesting one. A few: cycles later, the CPU 
acknowledges the. bus request by pulling 
BUSACK Low, the CRTC (device X) then executes 
its transfers. When the CRTC finishes its transfers, 
it releases BRQ and relinks its BAI input to BAO 
‘output, hence driving BAO Low. The Low 
propagates. through the daisy-chain, and_as | as long 
as one of the: BAO is High, the backplane BRQ line 
and the devices BRQ signals will be held Low due 
to detail “A” logic structure. 


Once all the BAO's have gone High, the backplane 
BRQ goes High, and the CPU ca control over 
the bus. 


DMA Transfer Operation 


The DMA transfer itself consists of data moves 
from memory into the CRTC, controlled by the 
CRTC's DMA unit. 


lf a control block is fetched, the words loaded are 
steered toward the internal control registers. If 
display data (characters or attributes) are fetched 
from memory, it is eleelee toward an internal row 


\ 


In both cases the CRTC must: | 


1. Output the address of the data location. 


? 


ADo-AD4i5 ee ADDR 
DS 
RIW 


“" CLK1 
; we 


2. Sample the WAIT input and stretch the read 


cycle if needed. WAIT is sampled only at the 
falling edge of the system clock in T2 of a Bus 
MasterReadcycle. —- ‘ 


3. Read the data and transfer it to the proper | 
destination (buffer or internal register). 


The Am8052 can address up to 16-Mbyte 
addresses as 256 pages of 64K bytes each. The 
upper address is updated ona demand basis, as 
outlined below: 


There is a upper address change between the 
previous fetch cycle and the current one, or this is 
the first fetch of a new frame. In either case, 
succeeding read cycles are preceded by a single 
write cycle to latch the new upper address 


address. (See Figure 2.25) 


There iS no upper address change since the 
previous fetch cycle and it is not the first fetch of a 
new frame. In this case the succeeding fetches 
are not preceded by a upper address write cycle. 
A new burst does not necessarily begin with a 


page address update. 


DMA Read and Write Operations 


The start of a DMA cycle is initiated by AS being 





DREN | 


<________ DMA READ CYCLE WITH__s_ __, 
NO PAGE CHANGE 


<—_____________—— DMA READ CYCLE WITH PAGE CHANGE ———_> 
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Ls a _ Figure 2-25 DMA Transfer Operation 
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driven Low, which indicates a valid address on the 
ADo-AD15 address/data lines. At that time DTEN 
is also driven Low and allows the valid address to 
be buffered on the system bus through external 
buffers. The valid address may be latched on the 
system bus on the rising edge of AS. 


During the first portion of a DMA read cycle with a 
page change, R/W is pulled Low. by the CRTC for 
three complete clock cycles, and the address 
present on the ADg-AD7 bus during T1 is the 
updated page address which should be latched 
externally on the rising edge of AS. Refer to 
section 6 on interfacing the upper address latch. 
' The CRTC never outputs an active DS during a 
write cycle. The next three clock oe represent 
a normal DMA read cycle. 


During T2 the CRTC ceases driving the ADg-AD 15 


bus with the address information, and DTEN goes 
inactive (HIGH). DS is driven Low as an indication 
to the memory system that it may drive the bus with 
the read data. Half of a clock cycle later, DREN is 
driven Low to enable the receiving buffers local to 
the CRTC. 3 





Data is captured by.the CRTC on the falling edge 


of the T3 clock cycle; then both DS and DREN 
return High. The system might turn off the data 
--with either DS or DREN. In both cases the data 
hold time required by the CRTC is satisfied. 


Wait Operation 


During T2 of the read cycle, the WAIT signal is 
sampled by the falling edge of CLK;. If Low, the 
cycle is stretched by one CL 1 cycle. However, 
the WAIT input can be operatéd’as a READY input, 
by taking Low as the default level. In botir cases, 
the input signal must satisfy the setup and hold 
time requirements of the CRTC, to avoid 
metastable conditions (see Section 6). 





The CRTC also has a software Wait state capability: 
zero, one or two wait states can be specified in 
Mode Register 1 and are automatically inserted in 
each Bus Master Read cycle independently of the 
WAIT input line. 


When both hardware and software Wait states are 
requested, they occur consecutively and not 
concurrently: The hardware Wait States are 
honored first, immediately followed by software 
wait states if so programmed. ) 


Idle DMA Cycles 


An Idle DMA cycle is a bus cycle (three clocks) 


during which the CRTC executes _ internal 


operations (e.g., row linkage and window overlay). 


Since Idle DMA cycles are single bus cycles, the 
CRTC does not release the bus; otherwise, bus » 
overhead would be increased. The CRTC 
releases the bus (burst of Idle DMA Cycles) only if a 
window or the background row needs to be filled 
with Fill Code characters. 


Each DMA burst executes in the following 
sequence: 


1. The CRTC asserts BRQ to arbitrate the bus. 


2. The CRTC waits for BAI to be asserted by the 
external bus arbiter (usually a CPU). 


°3. BAl.is sampled with the next rising edge of 


CLK,. If the set-up time (parameter 75) is not 
satisfied, the CRTC may perhaps not catch BAI 
with that edge, but definitely catches it with the 
next edge (metastable conditions cannot 
occur). ) 


4. Then BAlis internally synchronized to T2 of the 


running state machine. After synchronization 
the CRTC executes the first DMA cycle, which 
externally starts on the next T1 state. The time 
elapsed from receiving BAI is between six and 
eight clocks depending on when BAI comes 
relative to the free running internal state 
machine. 


Table of Idle DMA Cycles: 


The table below lists conditions were the CRTC 
inserts Idle DMA cycles (this list might not be 


complete). 


Event # of Idle 
DMA Cycles 

Begining of DMA burst if previous burst 
was preempted or counted out 0 
Begining of the first burst of a frame 1 
Begining of first burst for a new row 2 
Loading the Window Definition Block 1 
Loading a Row Redefinition Block 1 
Loading a Window Row Control Block 1 
Endofarow (background) 1 
. (window) 2 
End of preempted burst 0 
Fill Code segment (segment with _ 1 
character pointer equal zero) 
Window segment filled with Fill Code 


3clks/2char 
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DMA Burst Control 7 
During DMA action, the CPU is ‘denied access to 
_the bus and therefore cannot execute programs. 


This situation can lead to problems i in the interrupt 
response time of the CPU, since the CPU can only 


recognize and service an interrupt request while in 


control of the bus. Note that at the beginning of 
every frame, immediately after the vertical blanking 
interval, the CRTC tries to request the Bue 


To allow the CPU control of the bus ‘iia certain 
limits, a Burst Register is provided inside the CRTC 
and is programmable by the CPU. This Burst 
Register specifies a time slot during which the 


CRTC is allowed to request the bus. Both the time — 


slot duration and. its cycle time are programmable. 
For further information, refer to Section 2.3. 


2.5 ROW MANAGEMENT UNIT 
OPERATIONS 


The Row. Management Unit controls the system for 
fetching, interpreting, and steering the information 
contained in memory; loading the three row- 
buffers with displayable information; and updating 
internal registers to redefine some of the screen 
characteristics. 7 


- Listed below is the information that the Row 
Management Unit may steer for updating. 


Steer into the row-buffers: 
e characters 
e attributes 


Steer into the internal registers: 


alterable ona frame basis: 
e absolute cursorcoordinates (CUX, cuy) 
e fillcharacter code 


e blink control and parameters (for cursors and | 
characters) 


e scroll control and parameters | 


¢ interrupt vectors (for vertical event and smooth- 
scroll event 


alterable ona rowbasis: _ 

e totalscan line count per row (TSLc) 

¢ normal character start and end line numbers 
(NCS, NCE) 

e superscript character start and end scan-line 
numbers (SBCS, SBCE) | 

e subscript character'start and end scan- Aline 
numbers(SBCS, SBCE) » | 

e cursor pattern start and end scan-line numbers 
at CURE) 


r 


e underline position (UND) oe ae 
e shifted underline position (SUND) fe 


The information ‘to be fetched by ‘the Bai 
Management Unit is addressed by linked-list 
pointers, and the Row Management Unit keeps . 
track of the addresses of the information present in 
memory. The Row Management Unit also inter- 
prets window information when it is present. 


The final task performed by the Row Management 
Unit is the selection of displayable characters 
(which are. the only ones loaded into the row 
buffers) depending upon the “ignore” and “invis- 
ible aibole flag” bits settings. 


Windows 


The CRTC is capable of controlling and Seetavits 
a text file on the screen (known as background) 
concurrently with other text files embedded in. 
rectangles (known — as windows) positioned 
anywhere inside the active display area of the 
screen. With conventional. CRT controllers, this 
feature can only be implemented if the CPU is 
aware of the position and size of the window, with 
all the inconvenience and software complexity this 
implies. One of the important features of the 
CRTC is that it allows the CPU to process a © 
background file and a window file independently 


without being continuously. concerned with size_ 


and position of the window. 


- The CRTC holds two pointer registers; each 
containing the starting address of a linked-list 
residing in memory: one pointer corresponds ‘to - 
the background 


information, while. the other 
corresponds to the first window's information. The 
first window is the first one encountered when 
scanning the screen from top to bottom. The user 
is able to define an arbitrary number of windows on. 
the screen, as long as two background character 

rows (three for interlaced video) separate the | 


windows vertically. Virtual windows, however, may 


occur side by side (horizontal split-screen). 


Each window links to the following’ one (ranging 


‘from top to bottom of the screen) with a link 


pointer. There are no more windows when the link | 
pointer of the last window contains zero. 


Two main linked-lists reside in system memory 
holding the entire information ening a particular 
display: 


The sdehaieind list pointed to by Top of. Page 
(TOP) Register, containing the parameters of the 
pacngreu nd display. 
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The window(s) list pointed to by Top of Window 
(TOW) Register, containing the parameters of the 
window(s Sp OR RIAys” 


Depending upon the memory addressing scheme, 
the user can choose either of two addressing 
~ modes: segmented mode or linear mode. 


Segmented Mode 


The segmented mode divides the’ memory into 
pages containing 64K bytes each. The CRTC can 
address 128 pages. In this case, the pointer is 23 
bits wide arranged in two 16-bit words with the 
following configuration: | 


~ Seven bits pointing to one page among the 128 
addressable pages. These seven bits are right 
justified in the most significant byte of the first 16- 
bit word. 


16 bits pointing to the address within the selected 
page. These 16 bits constitute the second word. 


When operating in the segmented mode, crossing 
a page boundary does not increment the page 
number. It results in wrap-around operation within 
the same page. 


Linear Mode 


_ Inthe linear mode the CRTC addresses memory as 

one 16- -megabyte block,. with a 24-bit-wide pointer 
arranged in two 16-bit words with the following 
configuration: 


Eight bits representing the most significant part of © 


the address embedded in the least significant byte 
of the first word. 






ROW CONTROL BLOCK POINTER (PAGE) 
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ROW CONTROL BLOCK POINTER (OFFSET) 


ee ean 
Li a 
(ow [ome ZZ = T= T= [= [= [== 
veneer 


ZA MEZA ZZ_ | 


16 bits representing the least significant part of the 
address in the second word. 


In this mode, when the second word crosses a 
64K boundary, the first word is incremented by 
one. - i 


The selection between these two modes is 
accomplished through the L/S bit. in Mode 
Register 1. 


L/S=0 segmented mode enabled 
_L/S=1_ linear mode enabled 


Consistent with the byte addressing method used 
by all 16-bit microprocessors, ADp always outputs a 
“0” at address time. This means that the CRTC 
actually addresses 32K 16-bit words instead of 
64K bytes. This applies for both linear and 
segmented addressing modes. This implies that 
all character strings must start at an even address 
— they have to be word boundary aligned. 


Background Information Management 


The TOP (Top Of Page) Register points to the first 
data word of a block called “Main Definition Block.” 


_ This block is unique for each background list, and 


the information it contains is fetched on a frame 
basis and stored into the applicable internal 
registers of the CRTC.. Simply by changing the 
pointer in the TOP register entire pages can be 
swapped at an instant without any flickering. 


Main Definition Block (MDB) Overview 
The Main Definition Block contains seven data 


words (MDo-MDe) defined as follows (Figures 2.26 
and 2.27): 


Do ~* 











y-CURSOR (CUY) 






INT VECTOR (SOFT SCROLL) 


Figure 2-26 Main Definition Block (L/S = 0) 
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MDpo,MD4. Pointer to first Row Control Block 

MDg. Absolute cursor coordinates (“X” coordinate 
_ byte-and “Y” coordinate byte) 

MD3. Fill character code (one flag bit + one byte 
code) » = An 

MDq. Blink control/scroll control 

MDs. Interrupt vectors: vertical.event/scroll event 
MDg.. Total scan line count per row. 


MDB Detailed Description: 


MDy,MD,. The Row Control Block pointer points 
to the block defining the first row's control 
information. - 


MDo. 


_ this row where the absolute cursor is displayed. 
The topmost row is row “Q” the. leftmost Chakaclet 
position is sore | 


MD3. The fil character code is a user-defined 8-bit 
code. This is used as a filler in the row buffer if all 
the characters for that row have been loaded and 
did not fill the programmed buffer size. Segments 
with a character code pointer of “O” are also filled 
with the fill code. The number of visible characters 
(visible #) specifies the length of these segments. 
Windows, where the window segments do not fill 
up the window size, are filled by the fill code too. 


The flag bit’ (flag attribute), when set, causes the ~ 


CRTC to load an extra attribute word from the 
attribute list and use it as a latched attribute 
(immediately active) for the fill character. The extra 
attribute word must invoke a latched attribute. 


MD,: The blink control/scroll control is composed 
of 15 bits. 


Smooth-Scroll _ Enable (SSE) enables the 
smooth-scroll operation for either the background 


D15 
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MD; 






MD2 x-CURSOR (CUX) 


MD3 
wo[ oe [om [om [ore era 


MDs INT VECTOR (VERTICAL) 


MD6 





‘ora window. . 


The absolute cursor coordinates indicate. 
the row number and the character ‘position within | 


ae See 
Cid dddaddldddladdda 
So esos 

Lene 


0 Smooth-scroll disabled 
1 Smooth- ESO enabled 


Scroll Up/Down (SUD) ‘indicates the direction 
of the scroll. 


0 Smooth-scroll down 
1 Smooth-scrollup 


Scroll Window/Background (SWB) indicates 
whether the background or a window will be 
scrolled. . 


0 Smooth-scroll background 
1 Smooth-scroll window — 


Scroll Rate (SR3-SRo) is a 4-bit word 
specifying, the smooth-scroll rate according to the 
following table: 


SR3 SR2 SR, SRo Scroll Rate 


0 0 0 0 1 Scan Line/Frame 
0 0 0 1 2 Scan Lines/Frame 
(om 0 1 07 3 ScanLines /Frame 
0. 0 1 1 4 Scan Lines/Frame 
0 1 0 0 5 Scan Lines/Frame 
0 1 0 1 6 Scan Lines/Frame 
0 1 1 0 7 Scan Lines/Frame 
0 1 1 1 8 Scan Lines/Frame | 
| (fastest) 
1 0 0 0 1 Scan Line/Frame 
4 0 0 1 1 Scan Line/2 Frames 
1 0 1 0 1 Scan Line/3 Frames 
1 0 “4 1 1 Scan Line/4 Frames 
1 1 0  8°§6=—0 +1 Scan Line/5 Frames 
1 4 O 1 Scan Line/6 Frames | 
1 1 . 0 4 Scan Line/7 Frames 
1 1 We 1 1 Scan Line/8 Frames 


(slowest) 


Ds D7 
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ee 


ROW CONTROL BLOCK POINTER (LO) 
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Li 
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Figure 2-27. Main Definition Block (L/S = 1) 
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Cursor Blink Rate (CUB1,CUBO) defines the 


- blinking rate for both attribute and absolute 
cursors: 


Blink Frequency 


CUB; CUBg Blink Period (at 60 Hz Frame 
Rate) 
0 0 16 Frames 3.75 Hz 
0 1 32 Frames 1.85 Hz 
1 0 64 Frames — 0.93 Hz 
1 1 128 Frames 0.46 Hz 


* 


Cursor Blink Duty Cycle (CUD) 
CUD Cursor Blink Duty Cycle 

0 Blink Output 75% Inactive, 25% Active 

1 Blink Output 50% Inactive, 50% Active 
Character Blink Duty Cycle (CHD) 
CHD Character Blink Duty Cycle 

0 Blink Output 75% inactive, 25% Active 

1 Blink Output 50% Inactive, 50% Active 
Absolute Cursor Blink Enable (OXNBE) 

0 Cursor Blink Disable 

1 Cursor Blink Enable 

Attribute Cursor Blink Enable (CATBE) 


O Cursor Blink Disable 
1 Cursor Blink Disable 


Character Blink Rate (CHB;, CHBg) 


Blink Frequency 


CHB; CHBgBlink Period (at 60 Hz Frame 
Rate) 
0 0 ' 16 Frames _ 3.75 Hz 
0. 1 32 Frames 1.85 Hz 
1 0 64 Frames 0.93 Hz 
1 1 128 Frames 


0.46 Hz 


The character and the cursor can have different. 


blink rates and different duty cycles. - 


MDs. The Interrupt Vector Register contains the 
smooth-scroll and vertical event interrupt vectors. 
When one of these interrupts is activated, the 
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corresponding 8-bit vector is output on AD7~ADo 
at Interrupt Acknowledge time, if the NV-bit in 
Mode Register 2 is reset. 


The vertical event interrupt vector is totally user- 
programmable. 


The smooth-scroll interrupt vector is partially user- 
programmable: Bits 0 and 2 through 7 are user- 
definable, while Bit 1 reflects the state of the SIP 
(Scroll Interrupt Pending) bit. This feature allows 
the user to steer the smooth-scroll antermets into 
two different routines. 


SIP=1 The CRT is informing the CPU to execute a 
relink during scrolling operation. . 


SIP=0 The CRT does not need CPU intervention 


but signals the CPU thatthe scroll 
operation is completed. - 


MDg. TSLC is a 5-bit value defining the number 
of total scan lines per row minus one. This value is 
reprogrammable on a row basis via the Row 

Definition Block. : 


This TSLC must be Saal to the TSLC of the first 
row in the linked-list. 


In video interlace or RFI mode, the TSLCs of all. 
rows displayed must be even or the TSLCs of all 
rows must be odd. In non-interlaced video, rows 
with odd and even TSLCs may be mixed. 
However, this is restricted when. displaying 
windows (refer to Section 2.5.4). Figure 2.28 
shows the values of the total number of scan lines 
for all video modes. 


Row Control Block (RCB) 


Once the CRTC has loaded the Main Definition 
Block into its internal registers, it fetches the first 
Row Control Block (Figures 2.29 and 2.30). To 
ease text-editing procedures, the CRTC allows the 
user to split each row into segments. This 
partitioning is necessary when dealing with window. 
positioning within the screen. The “window” 
section provides detailed information.. Each 
segment may contain up to 255 visible characters 
and up to 255 hidden characters limited by the 8- 
bit counter. 


Hidden characters are characters that the CRTC 
fetches from system memory but that are not 
loaded into the internal.row buffers. They are 
identified by the Ignore Bit of the attribute word 
when DH in Mode Register 1 is reset. An attribute 
flag character is oe a hidden’ character if the 


4 


Invisible Attribute Flag (IAF) of Mode sia 1 is 
set. 


The CRTC pre-fetches two rows to keep all three. 


_ internal row buffers filled. This results in fetching 
two redundant rows at the bottom of the screen. 
To minimize bus occupancy of the CRTC these last 
two rows can be “termination Row Control Blocks.” 
This block consists of a Row Control Block Pointer 
pointing to itself, a Character Code Pointer set to 
“0,” and. C-flag=0 (a single, empty character 
segment). 


RCB Overview 


RAg,RA4. 
next Row Control Block. 


RAo.s. The first segment's block composed of 
five data words: 


The numbers of visible and hidden 
characters in the segment constitute the 


first data word, 

The segment's efaiadier ict pointer (next two 
data words), | 
The segment’ § attribute-list pointer 

(two words), 


Successive segments are identical to the first, 
An optional “Row Redefinition Block” pointer 
(two data words). 


The user must set at least one Row Redefinition 
Block after power-up. A Row Redefinition Block 
contains characteristics applicable to a row. This 
information stays latched until another Row 
Redefinition Block is encountered. If no Row 
Redefinition Block is fetched after power up, 


information such as character start and end scan 


lines is undefined. {If N segments are present in a 
- Row Control Block, its length is either: 


_ N*5+2 ifno Row Redefinition Block is present, 
N+5+4 ifa Row Redefinition Block is present. 


RCB Detailed Description: 


RAg,RA;. The most significant bit in the first 
word indicates if a Row Definition Block has to be 
_loaded for the current row. When this flag (LNK) is 
“4,” the Row Definition Block is loaded. The 
remainder of the first two words contain the link 
pointer to next Row Control Block. 


RA». The sum of ‘hidden and visible characters 
must be at least “1”. The number of hidden 
characters and the number of visible characters are 


! 


A two-word. link pointer pointing to the’ 


_ characters 


' the window. 


_ interpreted by the CRTC in the following way: 


No window within the current row ° 


The DMA uses the sum of the hidden and visible 
character numbers to determine the number of 
characters to be fetched. In this case the CRTC 
does not distinguish between those two numbers; 
it uses only the sum. Note, that the segment 
length is not determined by. #: Visible. The 
segment length is only determined by the number 
of visible characters the CRTC extracts out of the 
characters loaded in by DMA. 


Window within the current row 


Ina window, both the number of hidden and visible 
characters in background, and the number of 
window segments have to be specified correctly. 
The total number of hidden and visible characters 
determines the number of characters fetched from 
memory.’ The CRTC takes the number of visible 
in the segment and the window 
coordinates of the Window Block in order to place 
The specified number of visible 
characters for a particular segment has to match © 
the number the CRTC extracts from the characters 
loaded by DMA. 


__ TOTAL NUMBER OF SCAN LINES 
TSLC 


NON-INTERLACED = INTERLACED 
OR RFI MODE MODE 
00000 1 14+1=2 
00001 2 14+2=3 
00010 3 24+2=4 
00011 4 243=5 
00100 5 34+3=6 
00101 6 34427 
00110 7 44+4=8 
00111 8 44+5=9 
01000 9 5+5=10 
01001. 10 _ 54+6=11 
010105 11 6+6=12 
01011 12 6+7=13 
01100 13 747014 
01101 14 74+8=15 
01110 15 8+8=16 
01141 16 84+9=17 
W411 «82 


16+17=33 





Figure 2- 28 Total Number Of Scan Lines As 
A Function Of TSLC 





e 


2-32 


we” 





03901A-30 


a 





7 [—) 
n m o 
+—Z—-|. _25 aa 2a 
: 
ft 2 
= 4 oe 


~~ 93901A-31 | 
: Figure 2-30 Row Control Block (L/S = 1) 
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RA3/RAg. These two words contain the 
character code address pointing to the beginning 
of the character code string of this one and 
the continue bit(C). 


C=0 This is the last segment of this row. 
C=1 The segment list continues. 


if this pointer is. “O, "then the space specified by 
the visible number of characters for this segment is 
filled with the fill code. - 


RAs,RAg. 
of this segment. 


The segment header (RA3-RAg) must. be 
repeated for each additional segment. If the LNK- 
bit in RAg is set, the two words following the last 
segment header must contain the pointer. to the 
Row Redefinition Block. 


Row Redefinition Block 


The Row Redefinition Block is composed of five 


words. These words hold information relevant to 


the display characteristics of the row (Figure 2.31). 


RRg ‘Total Scan Line Count (TSLC) 5 Bits 
Normal Character Start (NCS) | 5 Bits 
Normal Character End (NCE) 5 Bits 

RR; Row Attributes 5 Bits 
Superscript Character Start (SPCS) 5 Bits 
Superscript Character End (SPCE) 5 Bits 

RR2 Row Attributes 5 Bits 
Subscript Character Start (SBCS) 5 Bits 

’ Subscript Character End (SBCE) 5 Bits 

RR3 = Cursor Start 5 Bits 
Cursor End «. 5 Bits 

RRq Double Row (DR) 2 Bits 
Underline(UND) 5 Bits 
Shifted pndetinaoune) 5 Bits 

Dis: D4a : S - Dio Doe 






Ye 


The pointer links to the attribute string 


~ horizontal smooth-scroll. 


Z 
a a 


All this information is captured by the CRTC. It acts 


on the invoking character row and succeeding 


ones until a new Row Redefinition | Block is 
invoked. ! 


The Total Scan Line Count Tsi6) definés the 
total number of scan lines per row minus one. 


Normal Character Start (NCS) and End (NCE) 
define the vertical position and height ot normal 
characters within the row. 


The same. definition applies to superscript and 
subscript characters with SPCS, SPCE, SBCS, 
SBCE. 


When the scan line count is less than ne character 


‘start scan line value (NCS, SPCS, or SBCS) or lar- 


ger than the character end scan line value (NCE, ~ 
SPCE, or SBCE), Ro-Rg puts out 1Fy. Figure 
2.32 shows an example. Normally the character 


slice with the address 1Fy is programmed to be 
blank. 


More details concerning these parameters. are 
included in Section 2.6, Attributes. 


There are ten user-definable row attribute. bits 
which are output on the APg-AP, and APg-AP yo 
pins during the horizontal retrace time. Bits Dy4 
through Dy9o in RRz are output on AP4 -APg, 
while bits Dy4 through Dy9 in RRo are output on 
AP,-APo. This row attribute can be registered 
externally to. the CRTC with the falling edge of 
HSYNGC. This feature can be used for a set of user- 
definable attributes or to implement functions 


' which are not directly supported by the CRTC; for 


example, loadable character font generator or 
Cursor start and cursor 
end applies to partial, reverse and underline 
cursors, and defines the position and height of the 
corresponding cursor. (See Section 2.6.5, Cursor 


Display.) 


The Double Row bits (DRy,DRo) allow the user to. 


insert double row characters in the text on a row 


Ds Da 
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Figure 2-31 Row Redefinition Block 
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Figure 2-32 Character Placement 


~ basis. The code is interpreted as follows: 


DR, DRo 
0 0 Normal Character Row 
0 1 Reserved 
1 0 Top Half of a Double Row 
1 1 Bottom Half of a Double Row 


f 


The linked-list for a double size row.consists of two 
Row Control Blocks, one for the top half of the row 
and one for the bottom half. The data accessed by 
these row control blocks should be identical, apart 
rom the DR bits in the Row Redefinition Blocks. 


Underline specifies the scan line number on which 
the underline attribute acts. | 


Shifted underline acts the same way as underline 
except that it applies to the shifted underline 
attribute. 


_ Row Redefinition Block Loading Process 
If RCB, initiates loading of a Row Redefinition 


Block (LNK=1), the CRTC will load the same Row 
Redefinition Block also for RoWpj,, (LNK=0) and 


RoWn,.2 (LNK=0) to get the new parameters also — 


for the two remaining row buffers. Note, that for 
these two rows the:CRTC only loads the Row 
Redefinition Block (5 words) and not the Row 
Redefinition Block Pointer (last two words of the 
RCB). This means, that the Row Redefinition 


Block should not be modified, until the oa has 


fetched these two rows. 


Window Information Management 


The Top Of Window Register (TOW) points to the 
first word of a Window Definition Block (WDB), 
which specifies the window characteristics. There . 
is one Window Definition Block per window, and 
they are linked together starting with the topmost 
window on the screen (whose WDB is pointed by 
TOW). If TOW=0, no window is displayed on the 
screen. 


The Window Definition Block defines the following 
parameters (See Figures 2.33 and 2.34): 


WDp,WD.. First Window Control Block _link- 
pointer (two words) - 
WD3,WD3. Next Window Definition Block link- 
pointer (two words) 


WDq. The start and end window Tow mets 
(one word) 


WDs. The. start. and end window character 
numbers Hens word) 


The Window Row Control Block Point points to the 
Window Row Control Block specifying the first row 
of the window. The most significant bit of WDo 
(Smooth-Scroll Window, SCW) indicates if this 
particular window should be scrolled: 


ScW Smooth-Scroll Window 
0 Window Smooth-Scroll Disabled 
1. Window Smooth-Scroll Enabled 


g 


Note, that smooth-scrolling does not occur until 
conditions specified in the Main Definition Block 
are satisfied. 


When the pointer to the next Window Definition 
Block is equal to zero, there are no more windows 
on the screen. Otherwise, the pointer indicates 
the address of next Window Definition Block. 


The start and end window row numbers are two 
bytes which indicate the vertical position of the first 
and last window rows on the | screen expressed in 
row number. 
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“WINDOW ROW CONTROL BLOCK POINTER (OFFSET 


— 


WINDOW DEFINITION BLOCK POINTER (OFFSET) . 


START WINDOW ROW # 


END WINDOW ROW # 





START WINDOW CHAR # END WINDOW CHAR # 
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“Biglire 2. 33 Window Definition Block (L/S = 0) 






Figure 2-34 Window Definition Block (L/S = 1) 


The most significant bit of WD2 must be “O”’when 
L/S=0. | 
The start and an window character numbers are 
two bytes which indicate the horizontal position of 
~ the first: aie last window characters onthe screen. 


As mentioned above, the Window Control Block is 

identical to the Row Control Block (Figure 2.35 and 

2.36). However, some restrictions should be 
observed when dealing with windows: 


Dg D7 


WINDOW ROW CONTROL BLOCK POINTER (LO) 


CLL La 


The number of visible characters of overwritten 


background segment is effectively interpreted. by 
the row management unit whenever a window is 
present within the row. 
present, the CRTC needs only the sum of hidden 
and visible characters of the loading segment to 
anOW the length of the segment | in memory. 


When no window is— 


The start and end positions of the window have to 


match segment boundaries in the background 
display. A window may eran multiple segments 
(see Figure 2.37). © a 


_ Only one window can exist between the row. 


) 
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numbers specified by start window row # and end 
window One: 


When fhe Saniante ofa winiow row's linked- ist do 
not fill the window's row, the fill code is used to fill 


the remaining character positions of that-window's . | 


row. During that time, the bus is not released and 
dummy DMA cycles are executed. 


The Window Redefinition Block (Figure. 2.38) is 
structured similar to the Row Redefinition Block. 
TSLC is left out, since a window row has to have 
the same number of scan lines as ane background 
row it ee 


2.6 ATTRIBUTES _ 


This section focuses on the Character Attribute 
architecture and the various character display 
options handled by the CRTC. Since the user may 
have very specific display requirements that match 
his own design, the CRTC has been designed to 
provide great versatility inthe attribute options. 


In the character stream two pieces of information 
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' Figure 2-35 Window Row Control Block (L/S = 0) 
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Figure 2-36 Window Row Contro] Block (L/S = 1) 
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are present: 
1. The actual character code. 
2. An attribute invoking flag that may be part of the 


character code, or a specific code by itself. This 
option is programmed via that Attribute Flag 


Register internal to the CRTC. The function of | 


this register is described in ‘Section 2.3 
(Register Description). | bt 


‘Once the choice of attribute-invoking flag(s) has 
been made it is possible to either display or inhibit 
the display of the flag by using the Invisible 
Attribute Flag (IAF) bit contained in Mode Register 


1. If IAF=0, each code invoking an attribute is. 
displayed, meaning that this specific code not only | 


_ invokes an attribute, but is also output on 
CCo-CC7 to address the character font generator: 
This character is affected by the invoked attribute. 
lf IAF=1, any code invoking an attribute is not 
loaded into the row-buffer and the invoked 
attribute then affects the following character. If two 
or more successive flags are present in the stream, 
only the last one (and the attribute it invokes) 







BACKGROUND: 
- WINDOW 1: 
WINDOW 2: 


WINDOW 3: po Seomenty 


’ encountered (see Figure 2.39). 
shows the Attribute Flag detect mechanism. | 


performance), 


SEGMENT 2) SEGMENT 3 SEGMENT 4 


SEGMENT 1 
| seements | 1 SEGMENT 2 


affects the first displayable character code 
Figure 2.40 


A character attribute is a code which affects the 
display characteristics of a character or set of 
characters on the screen. 


The CRTC distinguishes four levels of attributes: 


e Character attributes 
e Field attributes 

e Rowattributes 

e Frame attributes 


2.6.1 Demand Attribute Fetch 


The CRTC supports a flexible relationship 
between character code fetches and associated 
attribute fetches. Since attributes usually do not 
change on a character basis, the bus occupancy of 
the CRTC can be reduced (increasing . system 
by invoking attributes only at 
attribute transitions, i.e., demand attribute fetch. 


| SEGMENTS 3 
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Figure 2-37 - Window Overlay 
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Figure 2-38 Window Redefintion Block 
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After power-up, at least one latched attribute must 
be specified to set (initialize) the default attribute 
word. 


The CRTC supports various options; the three 
most common implementations are outlined 


below. All three options have similar implications: 


on text editing. They differ, however, when 
analyzing bus utilization and attribute editing. | 


Characters 


Option 1 


Option 2 


Option 3 


03684B-6 
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Option 1 


Each character code invokes an attribute. This is 
the most straightforward implementation, and 
editing is very easy. However, it puts the highest 
burden on the bus (low performance system). For 
this mode IAF=0 and the Attribute Flag Register 
contains 0000,). | 


Attributes 


One-For-One 


128 Character Codes, 
Change of Attribute 


255 Character Codes, 
Change of Attribute © 


FETCH 
ATTRIBUTE 
ENABLE 


Figure 2-40 Attribute Flag Defect Mechanism 
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Option 2 


A single bit within the character code specifies 


whether an attribute should be invoked. Adding or . 


_ deleting attributes involves two actions: 
Set or reset bit in character code 
Update the attribute list (block move) 


This options reduces the required bus bandwidth 
by about 50% (permanent savings), with the cost 
of a single data block move, to update the attribute 
list. Segmentation can reduce the editing 
overhead. However, it-increases the required bus 
bandwidth (larger RCBs). The editing impact to the 
character list is relatively low, but the character set 
is reduced to 128 characters. 


Option 3 


This option implements a demand _ attribute 
scheme with a character set of 255 characters and 
a single attribute flag character. Adding and 
deleting attributes involves two actions. | 


Insertion or deletion of the flag character (block 
move) 


Update of the attribute list (block move) 


This option, similar to the previous option, reduces 
the required bus bandwidth by approximately 

50%, but demands more CPU effort when editing 
the attribute list. : 


Character Attributes ; 
Character attributes are word quantities which 
affect various CRTC output signals and other 
operations on a_ character-by-character basis. 
These words reside in memory and are accessed 
via the attribute-segment pointers associated with 
the character-segment pointers in the Row Control 
Blocks. 
parallel with the corresponding character code in 


The character attributes are stored in . 


ee row buffer.. The bits in the attribute word are 
discussed below: 


The Attribute Port Enable and Attribute Re- 
definition Register affect the attribute processing. 
Refer to Section 2.3 (Register Description). . : 


Blink 


When this bit is set in the attribute word, the APo 
pin outputs a periodic signal whose rate and duty 
cycle are specified in the Main Definition Block. 
When this bit is reset, APo outputs a Low level. 
Blink may be programmed to be a user-definable 
attribute. In this case, no internal blink attribute 
processing is done. 


Underline 


When this bit is set in the attribute word, the AP, 
pin outputs a High for one scan line in the 
character cell. The scan line on which the 
underline is active is specified in the Row 
Redefinition Block and can, therefore, be changed 
ona row-by-row basis. If this attribute is made user- 
definable (see Attribute Redefinition Register), the 
pin is active for all scan lines of the character cell. 
Underline is active for two scan lines when 
displaying double-height rows. 


Shifted Underline 


This bit acts like Underline except that the signal is 
output on APs and the scan line number is 
specified by an independent 5-bit word also 
contained in the Row Redefinition Block. Shifted 
Underline also may be Overbar or Strike Through. 


Subscript 
When this bit is set, the affected character is 


displayed on a set of scan lines specified by 
subscript character start line number and subscript 


Attribute Word i salernasiee 


Bit 15: Latched/Unlatched 
Bit 14: Cursor 
Bit 13: Ignore Character 
Bit 12: Reserved 

| Bit 11: Reserved 
Bit 10: User-Definable 
Bit9: User-Definable © 
Bit8: User-Definable 


; Bit 7: User:Definable 


Bit6: Highlight 
Bit5: Reverse 
Bit4: Superscript 
Bit3: Subscript 
Bit2: Shifted Underline/Strike Through 
Bit1: Underline 
~BitO: Blink — 
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character end line number in the Row Redefinition — 


Block. This bit is generally used to display 
_ Subscript characters. In addition to this internal 
process, a High level is output on AP3 indicating a 
subscript character. This feature may be used to 
switch to a-different character font generator. The 
subscript attribute pin is active for all scan lines 
between start line number and end line number. If 
it is programmed to be a user-definable attribute, 
the pin is active for all scan lines of the character 
Cell. 


‘Superscript 


Similar to subscript. The set of scan lines is speci- 
fied by superscript character start line # and super- 
script character end line # in the Row Redefinition 
Block. The attribute is output on AP4. It can also 
be programmed to be a user-definable attribute. 


Reverse 


. When this bit is set, a High level is output on APs. 
This bit may be used to reverse the invoking 
character on the screen. No internal attribute 
processing is done, so this attribute can be treated 
as a user-definable one. Reverse is exclusive 
ORed with the reverse cursor. a 


Highlight 


When this bit is set, a High level is output on APg. 


This bit may be used to highlight the invoking 


character on the screen. No internal attribute 
processing is done, so it can be treated as user 
definable if desired. 


User-Definable 

These four bits have their state output on the 
‘matching pins (AP7-AP;9) and can be used as 
desired to affect the invoking characters. . 

Wgnore Character 


When the Ignore Bit is set to “1,” and the Display 
Hidden (DH) bit in Mode Register 1 is reset (“0”), 


neither the affected character nor its attribute code ‘. 


~ are loaded into the row buffer and thus are not 
displayed. When DH is set, the ignore characters 


(those having invoked the ignore attribute) are 


loaded along with their attribute code. The ignore 
bit is not put out on the attribute port. 
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Cursor 


If this bit is set, an attribute cursor is displayed at . 
the affected character position, dependent upon 
the mode of the cursor display logic. See section 
oncursor display. 


Latched/Unlatched 


When this bit of the attribute word is set (“latched”) 
the attribute information applies to all characters 
following the character that invoked the attribute 
word. This is described in more detail in the 
section on field attributes. This bit is not put out on 
the attribute port. . 


Character Attribute Timing 


The attribute information present on the attribute 
port is output coincident to, or one character clock 
after the invoking character, depending upon the 
skew-bits in Mode Register 1. This compensates 
skew between character codes and attributes, if 
external character code pipelining is required. 


Attribute Port Enable Register 


The function of this register is described in Section 
2.3, Register Description. The superscript and 
subscript effect are not cancelled by resetting the 
corresponding bits in this register; in fact, this only 
drives the corresponding attribute port pins Low. 
The internal attribute processing still takes place. 
To disable subscript and superscript action, the 
Attribute Redefinition Register must be used. 


The subscript and superscript, when endbled, may 
be-used to choose between a standard character 
generator and a specific character generator for 
subscript and/or superscript. However, in most 
applications, one standard font generator can be 
used for all three. , 


Attribute Redefinition Register 


Four user-definable attributes are srovided isi 
optional external attribute processing. If this 
number is not sufficient, then the highlight and 
reverse attributes may be used as user-definable - 
without any modification. | 

If this is still not enough, the user can disable the | 
normal effect of other attributes and turn them into . 

user-definable attributes. These attributes are: 


oe 


superscript | 

subscript 

shifted underline 
~ underline 

blink 


This yields 11 user-definable attributes. The 
function of the Attribute Redefinition Register is 
described in the Register Description Section. 


_ If.a user-definable attribute is directely mixed with 
the serial video signal put out by the,sAm8152A, 
the attribute must. be delayed by one character 
clock plus one dot clock. This. compensates for 
the internal delay in the Am8152A. 


2.6.2 Field Attributes 


A field attribute affects a set of successive 
characters. This feature 
consumption and software complexity compared 
‘to character attributes when dealing with character 
Strings. Field attributes are similar to character 
attributes and are implemented by setting the 
latched attribute bit. 


When a character does not invoke an attribute, it 
implicitly invokes the default attribute. Therefore, 
every character appearing on the screen is 
associated with an atrioule: in one of the following 
manners: _ 


-@ The character invokes either a latched or 
unlatched attribute. This attribute affects that 
specific character (if it is a displayable character). 


e The character does not invoke an attribute. The 
default attribute affects this character. 


Additionally, invoking a latched attribute also 
reloads the default attribute, As specified earlier, 
when an Ignore attribute is invoked and Display 
Hidden is reset, the attribute word and the 
character are not loaded in the Row buffers. 
However,. if the invoked attribute is a latched 
attribute, then the Ignore attribute is latched and 
succeeding characters are not loaded. On the 
other hand, if they invoke an attribute with Ignore 
reset, the ignore function is cancelled for all 
succeeding characters as soon as a latched 
attribute oe ignore bit reset is invoked. 


A latched attribute affects all. subsequent 
characters not involving attributes, whether they 
are in windows or background, until a new latched 
attribute is encountered.- As a result, a latched 
attribute wraps around the screen, ripples through 


TOWS, 


reduces memory . 


— background-window aS window- back- 
ground, etc. : 


2.6.3 Row Attributes 


The Row attributes are 10 bits that are output on 
APp-AP4 and APg-AP4o, .at horizontal retrace 
time. This is a CRTC feature that enables the user 
to modify display characteristics on a row- by-row 
basis. | 


The Row attributes are specified in the Row 
Redefinition Block and may be latched by external 
logic at HSYNC fall-time. Some examples in the 
applications of Row attributes will follow... The 
shape of the modified area(s ) is always a horizontal 
screen slice(s): | : 


reverse row(s) 

highlight row(s) 

blink row(s) 

color palette addressing 

row(s) underline | 

change character set 

switch to semi-graphic generator 
switch video output to a graphic 
display unit to mix graphic and text 
blank row(s) (Secret prompts) 


The row attributes are internally latched and do not 
need to be rewritten on each row. Therefore, the 
internal Row Attribute Register is updated each 
time a Row Redefinition Block is invoked (see | 
Figure 2-48 Row Attribute Timing). 


The row attribute word is output seven clocks after 
BLANK goes High and is removed one clock 
before BLANK goes Low.- However, a_pro- 
grammed skew between BLANK and the attribute 
output still applies. The horizontal timing para- 
meters must be chosen in such a way that the 
edge of HSYNC falls in the interval where the 
attribute port provides valid data. 


2.6.4 Frame Attributes 


Frame attributes affect the character display — 
characteristics of the entire screen. These 
attributes are stored in the Main Definition Block 
and define: 


x-y cursor positioning 

fillcharactercode . — 

x-y cursor blink rate and duty cycle 
smooth-scroll of window or background 
smooth-scroll rate and direction i 
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-2.6.5 Cursor Displays » 


Cursors are used to locate specific points in the 
text that need particular attention. Two types of 
cursors are supported by the CRTC: 


single absolute cursor (x-y cursor) 
multiple attribute cursors 


The Absolute Cursor 


This cursor is positioned on the screen. according 
' to its “X” (horizontal) and “Y” (vertical) coordinates 
specified in the Main Definition Block, and fetched 
by the CRTC during the vertical retrace time. 


“X” is expressed in character units. “X=0” indicates 
the first character column. “Y” is expressed in row 
units. “Y=0” indicates the first row on the screen. 
This cursor is called absolute because it refers to 
the screen boundaries and is not dependent upon 


the text displayed on the screen. When the text is - 


scrolled, the cursor position stays stationary 
relative to the screen. However, while the screen 
is smooth scrolling, this cursor stays with row “Y,” 
until the topmost row is relinked. At that time, the 
absolute cursor jumps to the new row “Y.” This 
behavior can cause the absolute cursor to move 
temporarily across background/window bound- 


aries. Therefore, while smooth scrolling mixed 
screens, absolute cursor display should be 


disabled. 


When the CRT monitor beam matches the cursor 
position, a CRTC internal cursor signal is activated 
to indicate the match. This signal may be steered 
internally to one of three output pins: cursor pin, 
reverse pin, and underline pin. 


The choice of the output pin is made through the 
cursor mask contained in Mode Register 2. -In the 
same register, a cursor enable bit, when reset, 
controls disabling the Absolute Cursor. Further- 
more, it is possible to partially affect the character 
position on the screen by specifying the scan line 
boundaries in which the output signal will be 
active. These boundaries are specified in the Row 
Redeftnition Blocks by CURS and CURE. 

The Attribute Cursor 

This cursor is positioned with the visible character 
that invoked an attribute with Cursor Bit=1. A 


display can therefore contain as many attribute 
cursors as there are character positions. 


An attribute cursor is implicitly linked to the text in 
which it is contained. If the text scrolls up, the 


attribute cursor scrolls with the text, whereas the 


absolute cursor would remain steady. 


When an attribute cursor is encountered, the same 
operation as with the absolute cursor occurs. 
However, a different set of bits in the cursor Mask 
Register steers the attribute cursor signal to one of 
the three outputs. This allows the user to distin- 
guish the attribute cursor from the absolute cursor 
onthe screen. The same scan line boundaries are 
used for both cursors. 


Cursor Characteristics 


One out of four shapes may be chosen for each of 
the two cursors described earlier: 


Cursor Whole. The cursor signal is output on 
the cursor pin for each scan line of the character 


position. 


Cursor Part. The cursor signal is output on the 
cursor pin for the specific scan lines contained 
between cursor start and cursor end boundaries 
specified in the Row Redefinition Block. 


Reverse. Same operation as cursor part except 
that the signal is output on the reverse attribute pin . 
after being exclusive ORed with the internal 

reverse attribute signal. 


Underline. Same operation as cursor part 
except that the signal is output on the underline 
attribute pin. : 


2.6.6 Fill-Code Attributes — 


When the Row Management Unit reaches the end 


of the last segment of a row, and the row-buffer is 
not full (96 characters or 1382 depending upon 
“slim” setting), the Row Management Unit fills the 
remaining space in the row buffer with a specific | 
code specified by the user in the Main Definition . 
Block. This code is the fill code, and needs special 
attention when it appears in text. Each time the 
row buffer is not filled by the contents of the linked- 


list, the fill code is loaded into the row buffer. 


lf the fill code is an attribute invoking code, the 
Row Management unit may not invoke an attribute, 
depending on the “FAT” bit in the Main Definition 
Block. If the user needs to display the fill code 


associated with an attribute, he should then set 


the “FAT” flag (Fill Code Attribute in the Main 
Definition Block) to one and add the desired 
attribute in the attribute list of the last segment 
invoked. Only one attribute word is fetched for the 
fill characters, so this attribute must be a latched 


Cd 
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sftiuié to. affect all fill elaracters loaded into Me 
_ row buffer. mS 


The ignore atinbuté is discarded when associated 
with the fill code. | 
2.7 INTERRUPT OPERATIONS 


An interrupt may occur whenever the CPU needs 
to be notified of various events internal to the 


CRTC or that an operation has just been. 


completed. There are two sources of CRTC 
interrupts: =. ; 


Vertical Interrupt 


The vertical interrupt, if enabled, can be used as a 


real-time interrupt by the CPU or it can be used as 
an indication that certain CRT updates should take 
place. The vertical interrupt is issued when the “n- 
th” character row has been loaded by the CRTC 
into its internal row buffers. The value of “n” is 
determined by the 8-bit VERTINT field in the 
HSYNC Register. When-“n’ is set to “1,” the CRTC 
issues a vertical interrupt after the last segment of 
_ the first row is completely loaded. (See also 
section on register programming.) | 


Smooth-scroll Interrupt 


The smooth-scroll interrupt is used to inform the 
CPU when to update the display linked-lists during 
-smooth-scrolling. See Section 2.8, smooth-scroll 
mechanism, for more details. ’ 


\ 


Interrupt Pigtoee! 


A complete jatewupt cycle consists of an interrupt 
request by the CRTC followed by an Interrupt 

Acknowledge of the CPU (Figure 2.41). The 
request, which consists of INT being pulled Low by 
the CRTC, notifies the CPU that an interrupt is 
pending. The 
notifies the peripheral that its interrupt has been 
recognized. In return, the peripheral may provide 
an interrupt vector to the CPU to identify itself (see 
the section on Row Management Unit). 


The CRTC. has two sources of interrupt and each 
interrupt source has three bits that control’ the 
issuance of an interrupt. These bits are the 
_ Interrupt Pending bit (IP), the Interrupt Enable bit 
(IE), and.the Interrupt Under Service bit {IUS). In 
addition to the control bits, two further bits control 
the interrupt behavior of the CRTC. These are the 
Disable Lower Chain bit (DLC) and the No Vector 
bit (NV) in Mode eee 


‘bit is “1”). 


- Interrupt Acknowledge bus cycle. 


Interrupt. Acknowledge cycle — 


Peripherals are connected together via «an 
interrupt daisy-chain formed with their IEI (Interrupt 
Enable In) and IEO (Interrupt Enable Out) pins. 

The daisy-chain resolves the interrupt priority. 


For the purpose of this description, the CRTC may © 
be considered as having two interrupt sources: 
Smooth-scroll, and Vertical Interrupt. The Smooth- 


_ scroll Interrupt has higher priority. 


Figure 2.41 is a state diagram of interrupt 
processing for an interrupt source (assuming its IE 
An interrupt source with an interrupt 
pending (IP=1) makes an interrupt request (by 
pulling INT Low) only if it does not have an interrupt 
under service (lUS=Low), no higher priority 
interrupt is being serviced (IEl=High), and no 
Interrupt Acknowledge transaction is in progress. 
IEO is not pulled down by the interrupt source at 
this time. IEO continues to follow IEl until an 
Interrupt Acknowledge occurs. Some time after 
INT has been pulled Low, the. GPU initiates an 
Between the 
falling edge of INTACK and the falling edge of DS, 
the IEI/IEO daisy-chain settles. AS is optional. Any 
interrupt source with an interrupt pending (IP=1) 
holds its IEO line Low. during Interrupt Acknow- 
ledge. All other interrupt sources make IEO follow 
IE] (transparent). When DS falls, only the highest 
priority interrupt source with a pending interrupt 
(IP=1) has its IE] input High and its IUS bit set at “0.” 
This is the interrupt source being acknowledged, 
and at this point it sets its IUS bit to “1.” If the 
peripheral’'s NV bit is “0,” the interrupt source 
identifies itself by placing the interrupt vector on 
ADj-AD7. Each time DS is activated during 
Interrupt Acknowledge cycles, the vector is put . 


out. The upper byte is driven Low. If the. NV bit is 


“1,” the peripheral's AD g-ADys5 pins remain — 


floating, thus allowing external circuitry to supply 


the vector. 


While an interrupt source has an Interrupt Under 
Service (IUS=1), it prevents all lower priority 
devices from requesting interrupts by forcing IEO 
Low. When interrupt servicing is complete, the 
CPU must reset the IUS and the IP bits. 


A peripheral's Interrupt Enable bit (IE) modifies the 
peripheral's behavior in the following manner—if 
the IE bit is “0,” the effect is as if.all interrupts from 
the peripheral are disabled. | However, the > 


peripheral can still set its IP bit if an interrupt ts 


required. If the IE bit is cleared while the source is 
driving INT Low, INT returns High until IE is set: To 


prevent race conditions, the CPU should mask out | 


interrupts from the peripheral before clearing IE. 
Note that IE, when cleared, also prevents the 
CRTC from responding to an Interrupt Acknow- 
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HIGH : 


HIGH 








BEBETDR guEE 





Low, LOW 


\ 


IP IUS IE 


HIGH LOW 


iP IUS IE 


IP tS IE 


STATE 7 


Transition Legend 


The peripheral detects an interrupt condition and sets 
Interrupt Pending. 


Alt higher priority peripherals finish interrupt service, 
thus allowing IE! to go High. 


An interrupt-acknowledge transaction starts, and the 
IEWIEO daisy chain settles. 


The interrupt-acknowledge transaction terminates with 
the peripheral selected. Interrupt Under Service (IUS) is 
set to 1, and Interrupt Pending (IP) may or may not be 
reset. ‘ 


The interrupt-acknowledge transaction terminates with a 
higher priority device having been selected. 


The Interrupt Pending bit in the peripheral is reset by an 
1/0 operation. 


A new interrupt condition is detected by the peripheral, 
causing IP to be set again. 


Interrupt service is terminated for the peripheral by , 
resetting IUS. 


IE is reset to zero, causing interrupts to be disabled. 


J+} IE is set to one, re-enabling interrupts. 


= 


. This diagram assumes MIE = 1. The effect of MIE=Ois 
the same as that of setting 1E=0. ig 


The DLC bit does not affect the states of individual 
interrupt sources. Its only effect is on the IEO output of 
a whole peripheral. 






4 El. 


Foo &@ oe. 


wo 


HIGH LOW 


IP IWS IE 





HIGH LOW 


IP WS IE 





STATE 6 


INT 





ANY 


LOW 


HIGH LOW 


= IP US IE 


STATE 8 


State Legend 
No interrupts are pending or under service for this 
peripheral. ee 


An interrupt is pending, and an interrupt request has 
been made by pulling INT Low. 


An interrupt is pending, but no interrupt request has been 


‘made because a higher priority peripheral has’an 


interrupt under service, and this has forced IEI Low. 


An interrupt-acknowledge sequence is in progress, and 
no higher priority peripheral has a pending interrupt. 


An interrupt-acknowledge sequence is in progress, but a 
higher priority peripheral has a pending interrupt, forcing 
IEI Low. : : 


The peripheral has an interrupt under service. Service 
may be temporarily suspended (indicated by IE! going 
Low) if a higher priority device generates an interrupt. 


This is the same as State 5 except that an interrupt is 
also pending in the peripheral. 


interrupts are disabled from this source because IE = 0. 


Interrupts are disabled from this source and lower 
priority sources because JE =0 and IUS = 1. 


. Transition | to state 6 or 7 can occur from any state 


except 3 or 4 (which only occur during interrupt 
acknowledge). . 


aN 


.. Transition J from state 6 or 7 can be to any state except \ 


3 or 4, depending on the value of IEI, IP, and IUS. 


Figure 2-41 State Diagram for an Interrupt Source 
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ledge. While IE is cleared, 
The peripheral's IEO line can be foreed 
unconditionally into the Low state by setting the 
~ DLC bit to “1.” 


2.8 SMOOTH-SCROLL MECHANISMS 


The Am8052 provides very powerful smooth-scroll 
_ Capability with minimum interaction by the CPU. 
Window(s) or background can be smooth-scrolled 
either up or down at a rate that is programmable via 


the scroll parameters field in the Main Definition © 


Block. Since the CRTC is designed to work with a 

linked-list structure, some: precautions should be 

_ taken when relinking the text after each scrolled 
row. 


General Smooth-Scrolling Rules 


Either windows or background can be scrolled at 
one time; they cannot be scrolled at the same time. | 


When a window splitting the screen vertically 
(sharing the row’ buffer with background 
‘characters) is intended to be smooth-scrolled, 


then all of its rows must have the same total scan 


line counts (TSLC). 


Double Buffering Technique - 


Smooth-scrolling operation is achieved by moving 
the appropriate data up or down on a scan line 
basis. Therefore, the CRTC adds an offset to the 
internal row's scan line count and outputs the 
result on Ro-Ry. This results in a displacement of 
the data on the screen by the number of scan lines 
equal to the offset. As soon as the last scan line 
(top or bottom depending on the scroll direction) 
of the first row of text has reached the top 
extremity of the screen, a text. relink.has to be 
made. This relink serves to push the disappearing 
row off the screen or to link a new row onto the top 
of the screen. 


In order to maintain a smooth relink transaction and 
allow for CPU time constraints, the Am8052 
controls the: relink timing through interrupts and 
double buffering of pointer register. As soon as 
the CRTC has begun smooth-scrolling a character 
row, it generates an interrupt. The CPU which 


maintains the linked-lists responds by writing to. 


“Top of Page (Window) Soft” a pointer value that 
provides the correct linked-list for the display after 
‘it has completed the scroll of the current row. The 
CRTC uses this new value as the active “Top of 
Page (Window)” only’ after the row scroll in 


IEO follows IEl. 


progress is completed.. This double buffering of 


the “Top of Page’ (Window)” values allows 


maximum time (one character row scroll time) for » 


the CPU to relink and respond to the interrupt. 


According to the preceding, when the user wants 
to smooth-scroll a portion of the display 
(background or window), he should define two 
Main/Window Definition Blocks, and flip between 
those two blocks each time a smooth-scroll 
interrupt occurs. This. technique allows the user to 
execute the link modifications. on the unused 
definition block while the other is being processed 
by the CRTC. | 


Detailed Interlock Mechanism: 


The Top of Page/Window Soft is the key interface 
between the CPU and the CRTC when dealing 
with smooth-scrolling. 


When the CPU writes a pointer value into this 
register, it does not modify the actual Top of 
Page/Window Register (Hard Register) used by 
the CRTC to fetch the Main/Window Definition 
Block. In fact, the transfer between this temporary 
register to the actual register takes place according 
to the smooth-scroll algorithm internal to the 
CRTC. Therefore, if the smooth-scroll process has 
not been enabled, writing to Top of Page/Window 
Soft does not change anything in the link 
architecture and this register should be used only 
if smooth-scroll operation is (or will be) performed. 
lf the user wants to change the link in a non- 


smooth-scroll condition he should use the “Top of 


Page/Window Hard” Register. 


The smooth-scroll mechanism is enabled by 
setting the Smooth- Scroll Enable bit (SSE) in the 
Main Definition Block. Two other bits in the Main 
Definition Block are used to select Window/ 
Background scrolling and -Up/Down scrolling 
directions. Additionally, when scrolling windows, 
the Smooth-Scroll Window bit (SCW) in the 
corresponding Window Definition Blocks must be 


set. All windows which have SCW set are-_scrolled 


simultaneously. Windows which have SCW reset 


_ remain steady. 


Smooth scrolling is stopped by resetting the 
enable bit (SSE-Bit) in the Main Definition Block. 


When the backgreund is scrolled only Top Of 
Page Soft needs to be updated; loading Top of 
Window Soft has no effect. Similarly, when 
scrolling windows only Top o Window Soft is 


relevant. . 


Pa 


Scroll Down 


The Top of Page/Window Hard Register links to 
the Main/Window Definition Block of the currently 
displayed text. When a down scroll is initiated, the 
current text is moved down a fraction of a row. The 
empty space at the top of the screen is filled with a 
fraction of the scrolled-in row. Therefore, the 
CRTC has to know the pointer to the new 
Main/Window Definition Block before it can start 
scrolling. The pointer is loaded into the Top of 
Page/Window Soft Register. 


The programming sequence shown in Figure 2.42 
refers to both scrolling background or windows. 


* CRTC 
REGISTERS 


MDBs, 
WDBs 


- (2) 3) : INT 
TOP/TOW TOP/TOW TOP/TOW 
HARD SOFT HARD 


The example shows two rows scrolling in a 
background or window consisting of a total of four 
rows. When scrolling the background the TOP 
Soft Register is reloaded and two Main Definition 
Blocks are used to implement the “Double Buffer” 
technique. If a window is scrolled, the TOW Soft 
Register and two Window Definition Blocks are 
involved. The numbers in the programming 
sequence below correspond to Figure 2.42. 


1. The CRT system displays a steady screen. The 
TOP/TOW Hard Register links to a MDB/WDB 
with smooth-scroll disabled. The smooth-scroll 
process is initiated from this steady state. 


SIP = 1 SIP =0 


(5) INT 
TOP/TOW' 
SOFT 





' RCBs, 
WRCBs 


ORIGINAL 2ND ROW 


ORIGINAL 3RD ROW 
ORIGINAL 4TH ROW _ 
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2ND SCROLLED IN ROW 


1ST SCROLLED IN ROW 


ORIGINAL 1ST ROW - 


Ne ons 









AFTER SCROLLING DOWN 
TWO ROWS (5) 


BEFORE SCROLLING (1) 


Figure 2-42 “Scroll Down Sequence 
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2. The CPU prepares another MDB/WDB with 

- smooth-scroll enabled. This MDB/WDB con- 
tains a pointer to the RDB/WRCB for the 
scrolled-in row which in turn points onto the first 
row currently displayed on the screen. The 
CPU loads the pointer to this MDB/WDB into 
TOP/TOW Soft Register. 


3. The CPU then enables smooth-scrolling by 
setting the smooth- scroll bit in the MDB/WDB 
described in Step 1. The CRTC detects this 
change when it fetches this block during the 
next vertical retrace period. The first frame after 
this change still reflects the same unscrolled 
display. Scrolling begins with the following 
frame. If the TOP/TOW Soft Register was not 
initialized, the start of scrolling waits for the 
initialization. At this time the CRTC transfers 
the contents of the TOP/TOW Soft Register to 
the TOP/TOW Hard Register to allow scrolling 
to the new row. It issues an interrupt on 
smooth-scroll event to notify the CPU that the 
TOP/TOW Soft Register can be updated. The 
update can take place at any time until the new 
row is entirely scrolled-in. If the update was not 


performed at that time, the displayed text — 
scrolls up (hard-scroll) one row and this same. 


row is smooth-scrolled in again. 


4. The TOP/TOW Soft Register is relinked to the 
MDB/WDB pointing to the RDB/WACB of the 
next row to be scrolled-in. If only one row 
should be scrolled, Step 4 is left out. For 
scrolling “n” rows, Step 4 is repeated after each 
interrupt issued by the CRTC “n—1” times. 


5. To stop the smooth-scroll process, the new 
‘pointer in the TOP/TOW Soft Register points to 
a copy of the previous MDB/WDB in which the 
SSE-bit is cleared. Scrolling of both 
background and windows is stopped by 
resetting SSE. The CRTC notifies the host 
CPU that smooth scrolling is completed by 


issuing a last smooth scroll interrupt with SIP 


(Smooth Scroll in Progress) being reset. 


2 


Scroll Up 


The numbers in the programming sequence below - 


correspond to Figure 2.43. 


1. The TOP/TOW Hard Register links to the. 


MDB/WDB of the currently displayed text. 
~ Smooth-scroll is disabled. 


2. The scroll process is initiated by enabling 
smooth-scrolling in the MDB/WDB. _ The 
-TOP/TOW Soft Register does not need to be 


* 


loaded at that time. The last row displayed links 
to the row to be scrolled-in. The CRTC detects 
the change of the scroll enable bit when it 
fetches the block during the next vertical » 
retrace period. After it has started smooth- 
scrolling it issues an interrupt on smooth-scroll 
event to make the CPU update the TOP/TOW 
Soft Register. a 


3. The TOP/TOW Soft Register links to the 

_ MDB/WDB pointing to the RCB/WRCB of the 
row following the scrolled-out row. If only one. 
row should be scrolled, Step 3 is left out. For 
scrolling “n” rows, Step 3 is repeated “n—1” — 
times. | 


4. To stop the smooth-scroll process, the 
TOP/TOW Soft Register points to’a MDB/WDB 
with scroll disabled (SSE=0). 


Smooth Scroll in Progress Bit (SIP-Bit) 


The SIP-bit is a status bit in the Mode Register 2 
indicating to the CPU that the CRTC is actually 
scrolling either window or background while the 
SSE bit (Smooth-Scroll Enable) is set. The SIP bit 
is set as soon as the CRTC has loaded the Main © 
Definition Block with SSE=1. Nevertheless, once 
the CPU resets SSE to “0,” the CRTC waits until 
the entire smooth-scroll is finished before 
resetting SIP to “0.” Furthermore, when using 
vectored interrupt, the SIP bit appears in Bit 1 of 
the interrupt vector and, therefore, allows the user 
the ability to vector to two different programs 
depending on the status of smooth-scroll without 
polling the SIP bit. 


The CRTC scans the SSE-bit in the Main Definition 
Block only at the top of the frame (not scrolling) 


, and after transferring TOP/TOW soft register to 


TOP/TOW hard register (previous frame was 
smooth scrolled). After scanning the MDB, and a 
relink took place, and the previous frame was 
scrolled, then the CRTC sets the interrupt pending 
bit for smooth scroll. At that time the SIP-bit 
reflects exactly the state of the SSE-bit in the 


~ scanned MDB. 


lf at that time SSE=1 the CRTC issues an interrupt 
with SIP=1 asking the host CPU to load a new 
pointer into the soft register; a pointer required for 
the subsequent relink. In this case scrolling 
continues. : | 


If at that time SSE=0 the CRTC issues an interrupt 
with SIP=0 notifying the host CPU that scrolling 
has been terminated. 


2-48 


“Smooth-Scroll Parameters 


IUSS. Interrupt Under Service for Smooth-Scroll 
operation (Bit 2 in Mode Register 2) is set either by 
_a hardware interrupt acknowledge (INTACK Low) 
or by a software interrupt acknowledge (host CPU 
sets oe) 





IES... Interrupt Enable Smooth-Scroll Bit 1 ‘in 
Mode Register 2. enables smooth scroll interrupts. 
Alternatively, the host CPU can poll the interrupt 


pending bit to perform the smooth scroll relinks. 


SIP = ee 


. (1) . 
CRTC TOP/TOW TOP/TOW 
REGISTERS HARD HARD 


MDBs, 
WDBs » 












RCBs, 
WRCBs 
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ORIGINAL 1ST ROW 


ORIGINAL 2ND ROW 


ORIGINAL 3RD ROW | 
- ORIGINAL 4TH ROW 
1ST SCROLLED IN ROW 


2ND SCROLLED IN ROW 


This bit can only be set and reset by the host CPU. 


IPS. Interrupt Pending for Smooth-Scroll event. 
Bit 0 in Mode Register 2. This bit indicates that the 


~ smooth scroll logic requires service by the host 


CPU. This bit is set by the CRTC or the CPU, and 
reset only by the CPU. It it independent of the 
state of IES. 


SIP. Scroll in Progress, Bit 8 in meee Register 2: 


' Setand reset by the CRTC. 


SIP = 1 SIP =0 


(3) (4 IN 
TOP/TOW TOP/TOW si 
SOFT SOFT 
SSE=0 
| suD=1 


BEFORE SCROLLING (1) 






AFTER SCROLLING UP 
TWO ROWS (4) 


2.9 SYNCHRONIZATION 


The CRTC has ‘two built-in, synchronization 
mechanisms: External SYNC (ESYNC) and Reset 
for Test (RSTT). These mechanisms are activated 
by applying signals to the synchronization input 
pins (ESYNC and RSTT). The ESYNC input 
synchronizes the CRTC to an external frame 
‘frequency. In most applications this input locks the 
vertical timing to the power-line frequency to avoid 
screen swimming. RSTT synchronizes. multiple 
CRT controllers. | 








Multiple CRT Controller Synchronization 


The Reset for Test (RSTT) input synchronizes two 
or more CRTCs. This synchronization sequence is 
executed only upon system initialization. Figure 
2.44 shows the timing diagram. RSTT can 
synchronize multiple CRTCs only once after power- 
on, ‘because applying RSTT would corrupt the 
display. It cannot be used to synohronize multiple 
CRTCs on a frame basis. This means, that all 
CRTCs have to programmed in a way that they 
operate synchronously forever (e.g. same clock 
and same timing parameters).: The sequence of 
operation for RSTT is: | 





Reset all CRTC's by pulling Reset (RST) Low for at _ 


least five clock cycles (CLK, or CLKo, whichever! is 
slower). . 


After RST becomes inactive, initialize all CRTC 
le including Mode Register 1 and 2 with 
DE=0. 


Activate RSTT synchronous to CLK; or CLK» 
depending on the CLK1/2 bit in Mode Register 1. 
It must be synchronous to the clock determining 


the frame timing. It must meet the set-up time t, to 


RST in, omamey / 


avoid metastabie problems. . 


Reload Modé Bea sier 1 and 2.. Set DE=1 (Mode | 


Register 1). ; 
Deactivate RSTT synchronous to CLK, or CLKo. 
RSTT must be active for a minimum of five clock 
cycles and its rising edge must meet the hold time 





_ requirement. The rising edge of RSTT triggers all 


CRTC's to Start display synchronously. . Detailed 


_ Reset for Test Timing is shown in Figure 2.44, 


External Sync Operation - 


The ESYNC input allows synchronization of the 
CRT display vertical frame rate to the power line 
frequency to eliminate waviness and other effects. 
The ES bit in Mode Register 1 defines whether 
ESYNG controls the Vertical Sync rate. 


ESYNC is recognized by the CRTC for every field 
or frame. It causes the VSYNC signal to become 
active at the occurrence of HSYNC. In non- 
interlaced mode, VSYNC becomes active at the 
first rising edge of HSYNC following ESYNC's 
rising edge (Figure 2.46). In interlaced mode, 
VSYNC comes active at the next HSYNC active 
when in the even frame, or in the middle between 
two HSYNC's in the odd frame (Figure 2.47). 


The VSYNC and HSYNC are inactive (BLANK is 
active) before, during, and after reset. When the 
display is enabled via mode bit DE, HSYNC output 
becomes active, while VSYNC waits for ESYNC 
active. The iced is delayed up to one ESYNC 
period. 


ESYNC cannot be used to synchronize multiple 
CRTCs, since it synchronizes only VSYNC, but not 





—>| ts + MIN 5 CLK ———> | tH [+ — 
2 ‘ 


Figure 2-44 
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Reset for Test Timing 
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HSYNC. Only RSTT can synchronize multiple 
CRTCs. 


2.10 RFI and INTERLACED VIDEO . 


There are two types of interlace, Repeat Field 
Interlace (RFI) and Interlaced Video (IV). Both 


types use the same vertical and horizontal timing — 


as described in the Vertical and Horizontal Timing 
Section. Both schemes offset the vertical position 
of the scan lines of the odd numbered fields so 
that they are physically interleaved with the scan 
lines of the even fields: For RFI, the same video 
information is displayed on both odd and even 
fields. The slight offset of the odd field eliminates 


the horizontal stripes that sometimes occur 


between scan lines on non- “interlaced displays. 
_ (See Figure 2.48) 


Interlaced Video is used to increase the amount of 
information . displayed on a monitor .without 
increasing the horizontal or vertical scan rates. IV 
takes advantage of the odd field scan line offset by 
displaying half the video in the even field 
(alternating lines) and half in the odd field. The 
effect is to essentially double the vertical character 
density with respect to RFI or non-interlaced video. 
One problem with IV is the potential imbalance of 


CLK 1,2) 


* HTC+1 

HTC+1 : 
aa | \— HSYNC+1 
7CLK 


2 


RSST 
HSYNC 
VSYNC 

HBLANK ‘2 


VBLANK (2) 


CRT beam current between the odd and even 


fields and the resulting loss of perfect video 


interleave. This. imbalance is greatest if the 
character rows consist of an even number of scan 
lines (adding up the scan lines in the even field 
and the odd field). 


Restrictions for Interlace Video | 


The restrictions mentioned below apply only to | 


Interlace Video. They do not apply to RFI or non- 
interlace video. 


lf smooth scrolling is disabled, any mixture of 
background and windows can be displayed, as 
long as windows are horizontally separated by 
three or more character rows (not scan lines). 
Windows should not overlap horizontally. 


The Am8052 does not support split-screen 
smooth-scrolling in Video Interlace mode. Also, in 
Video Interlace mode, a screen containing only 
background and no windows can only be smooth- . 
scrolled if all rows have an even scan count (TSLC 
even) and the number of: scan lines scrolled per 
frame is also even (scroll rates: 2, 4, 6, 8 scan 
lines/frame. No scrolling restriction applies to non- 
interlace or RFI video. 





() CLK1 OR CLK2 DEPENDING ON CLK1/2 IN MODE REGISTER 1 


(2) BLANK = HBLANK + VBLANK 
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Figure 2-45 Detailed Reset for Test Timing Diagram 
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VSYNC : 


; ODD FRAME ————- > + EVEN FRAME 


4 


/ 


7 03901A-46 
Figure 2-47 Interlaced ESYNC Operation 


5 CLK + SKEW") 





| 5cLK+skew 


4 ROW ATTRIBUTES 


12CLK,+SKEW™ = 4CLKy + SKEW" 







BLANK 


HSYNC 


AP 0.4) 
AP6.-10 





(1) “CLK IS CLK , OR CLK, , DEPENDING ON PROGRAMMING OF 
MODE REGISTER 1 (Dy5). SKEWIS CLK, OR CLK, CYCLES; 
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CHAPTER 3 


- SOFTWARE COOKBOOK 





3.1 INTRODUCTION 

The previous chapter discussed the capabilities 
and features of the CRTC in detail. 
the hardware and software design engineer, 
supplying all the information about the Am8052 
needed to design a CRTC based CRT subsystem. 


This chapter addresses the software design 
engineer in particular. It accesses all the related 
topics, when programming the CRTC. The first 
section (3.2) describes how the CRTC internal 
control registers are to be programmed. For frame- 
timing-register programming, refer to Chapter 
2.3.4. The second section (3.3) guides the reader 
in setting up the linked-list display data structure in 
memory. Section 3.4 covers window and 
background strategies and what happens when 
windows are not aligned correctly. The fourth lists 
hints on attribute incorporation. Smooth-scrolling 
is described in Section 3.6. Several diagrams and 
flowcharts aid the reader in understanding the 
- appropriate programming sequence. Section 3.7 
shows how easy -text editing becomes when 
operating on a linked-list data structure. The last 
section contains three sample programs written in 
28002 assembly language. 


The user must perform the six steps listed below to 
set up a display consisting of paesgroune and 
windows: 


Initialize the 20 control and timing registers of 
the CRTC. ) 


Prepare the character strings (segments) for the 


It addressed 


background and window text. These segments _ 


-can be placediin any order in memory. 


Prepare matching attribute word — strings 
(segments) for the background and window text. 
The rules for invoking attributes are’ described | in 
Sections 2.6 and 3. o. 


Define a. Main Definition Block ' for the 


segments together. 


e Define a set of Row Redefinition Blocks and 
Window Row Redefinition Blocks. The CRTC 
must encounter at least one Redefinition Block 
after power-up to initialize the internal registers 
storing the row attributes. 


3.2 REGISTER INITIALIZATION 


The CRTC contains 22 control and_ timing 
registers. To prevent damages to: monitors all 
timing registers should be loaded with the desired 
values before the display is enabled by setting the 
DE-bit in Mode Register 1. Section 2.3.2 
describes how the CRTC. registers can be 
accessed in Slave Mode. The following para- 
graphs suggest vallles to be programmed in the 
control registers. , 


Mode Register 1. A hardware reset (RST input 
pulled Low) or a software reset (DE-bit in Mode 
Register 1) clears it initially. After the linked-list in 
memory is set up and after all other register are 
initialized, Mode Register 1 is reloaded with the DE- 
bit set to one. The Display Hidden feature (DH-bit 
in Mode Register 1) is intended as a debugging . 
tool for the system programmer. If the DH-bit is set, 
characters with the invisible-attribute set are 
displayed. Also, when the DH-bit is set, the rows 
of displayed windows may not be aligned. 


Mode Register 2. The’ CUE-bit enables the X-. 
Y cursor. The two cursor mask fields (ACMO0,1 and 
XYCMO,1) define the layout of the attribute and X-Y 
cursor. For example, to specify the attribute cursor 
as a blinking underline, the attribute cursor defini- 
tion “Cursor Pin Part” is selected, the Attribute 
Cursor Blink Enable bit (CATBE) in the Main Defini- 


_tion Block is set, and Cursor Start and End scan 


.line numbers in the Redefinition Block are equal. 


IES and IEV enable the interrupts on smooth scroll 


_- background, and a Window Definition Block for: 


each window present on the screen. 


Set up a Row Control Blocks linked-list for the 
background text and a Window Row Control 
Block linked-list for each of the windows 
present. Each Control Block defines one row by 
linking. the. appropriate character and attribute 


or vertical event (refer to Section 2.7). 


Attribute Port Enable Register. Unless the 
user wants. to disable _any existing attribute 
features, a value of 67FFy in the Attribute Port 
Disable . Register is recommended ‘(refer to 
Sections 2.6 and 4.5). Subscript and Superscript 


_can only be disabled by programming ah Attribute 
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Redefinition Registerbelow. 


Attribute Redefinition Register. 
ter should be set to 0000}, unless the user wants 
to redefine the attribute bits for other purposes. : 


Top of Page Hard Register & Top of 
Window Hard Register. These four registers 
link to the Main Definition Block and the first 
Window Definition Block. In non-soft-scrolling 
applications the CPU reloads the “hard" register 
when altering pages or windows. 


Top of Page Soft Register & Top of 
Window Soft Register. These four registers 
hold temporarily the updated pointers to the Main 
Definition Block and the first Window Definition 
Block. After soft-scrolling an entire row, the CRTC 
updates the “hard” pointer with the pointer stored 
in the “soft" register. This double-buffering tech- 
nique keeps the CPU response time constrains as 
low as possible. If smooth-scroll is disabled, any 
write to the TOP Soft Register or the TOW Soft 
Register will be disregarded by the CRTC. 


Attribute Flag Register. 
for programming hints. - 


a) 


Refer to Section 3.5 


Burst Register. 
and burst space specified in this register 
determine the ratio the CRTC is allowed to gain 
mastership of the system bus. The reader must 
keep in mind that bus bandwidth for the CRTC 
must be sufficient enough the fetch the display 
information. If the allocated bus, bandwidth is too 


low, the screen may only show partial rows, 


repeated rows, or may be garbage. The burst 
count and burst space should be programmed to 
~ fulfill this requirement in worst case. 


Vertical Interrupt Row Register. This regis- 


ter determines the row number which (after being 


completely loaded) causes the vertical interrupt. 
The vertical interrupt can be used either to drive a 
real time clock or to notify the CPU that a certain 
row just has been loaded. This guarantees that 


This regis- 


CRTC only compares the characters against the at- 
tribute flag mask to decide whether this character is 
an attribute invoking character. The character font 


is stored in the external character font generator. 


The .16-bit attribute words are stored in attribute. 
strings, called attribute: segments, corresponding 
to the character segments.’ The character and 
attribute segments of each row are bound toge- 


ther by the Row Control Blocks (window or back- 


ground). In the Main Definition Block are the head- 
ers of background linked list consisting of Row 
Control Blocks. The Window Definition Blocks are 
the headers of the window linked-lists consisting 


_ of Window Row Control Blocks. For details refer to 


The values ci the burst count ' 


the CRTC does not scan this part of the linked list — 


for about one frame time. The CPU can update 
this row. 


Timing registers. 
2.3.4 for description. 
3.3 BACKGROUND AND WINDOW TEXT 

The background and the window text is stored in 


the system memory as character strings called 
character segments. The characters are byte quan- 


tities usually encoded in ASCII (American Standard | 


Code for Information Interchange). However, 
there is no restriction to the ASCII code. The 


Refer to Sections 2.3.3 and - 


Section 2.5. 


Main Definition Block and Window 
Definition Blocks 


The following paragraphs list some suggestions 
how to set up the Definition Blocks. X and Y.are 
zero-origin. 


Main Definition Block: 


MDo-MD,. Contains the pointer to the first 
Bacnarent nd Row Control Block. 


MD». If an X-Y cursor is desired, the user must set 
the CUE-bit. in Mode Register 2 and load MDo with 
the cursor's x and y coordinates. If an X-Y cursor is 
not desired, the user should reset the CUE-bit. 


MD3. The CRTC will put the fill character code into 
the portions of the line buffer not filled by visible 


characters. For example, if the fill character code is 


a blank character and the text segments occupy 
100 of the 132 characters of the line buffer then 
the CRTC will assign blanks to the. omens 32 
eau of the line buffer. 


Setting the FAT-bit will cause the CRTC to load 
one attribute word for the first fill character of the fill 
character string. This attribute should be a latched 
attribute to effect the entire fill character string. 


MD 4.. The cursor or character blink rate can be 
programmed from 0.46-3.5 Hz assuming a 60 Hz 
frame rate. A 75% output inactive duty cycle will 
make the character visible 75% of the time while a 
50% output inactive euly eycle wm make it visible 
50% of the time. | 


The slowest: programmable smooth scroll rate is 


one scan line per eight frames and the fastest is 
aoe scan lines per frame. 


MDs. When an interrupt is issued by the CRTC to 
the ‘host processor, the CRTC returns a vector 
number stored in MDs (soft scroll or vertical inte- 
rrupt) if the NV bit in Mode Register 1 is set to zero. 


MDg. The TSLC value in MDg is applicable only 
‘when the CRTC is scrolling rows with variable 
TSLCs (refer to Section 3.6). The TSLC in MDg is 
set equal to the TSLC of the first displayable row. 


Window Definition Block: 


_ WDo-WDy. Points to the first Window Row 
Control Block (the first displayable row in the 
window). The SCW bit should be set if the window 
iS going to scroll. 


WD2-WD3. If another window exists after this 


one, then WDz and WDg3 contain the pointer 


address of that. window's Window Definition Block. 
If no further window exists then WD2 and WD3 
contain zeros. 


WD,. Specifies the vertical positioning of the 
current window in terms of the position of the first 
row of the window (“0” for the topmost row) and 
the last row of the window. 


WDs. Specifies the horizontal positioning of the 
current window (“0” for the leftmost character). 


* 


Background Row Control Block and 
Window Row Control Block 


A Row Control Block describing a row containing 
only one segment has a length of seven words 
(nine words including the pointer to the optional 
Row Redefinition Block if LNK is set). If the row is 
partitioned into segments, each segment adds five 
words to the standard length. Segmented rows 
are desirable because they simplify editing tasks. 
Segmentation is required when displaying win- 
_ dows (refer to Chapter 3.4). 


Example of Row Control Block (one segment) 


RAg 800017 _Link bit (LNK) is set to make the 
CRTC fetch the Row Redefinition 
Blockpointer. The upper address is 
set to zero assuming less than 64. 

kbytes of memory is used. , 

RA; . XXXXy Address of next Row Control Block 

RAp 00104 No hidden characters and 16 
displayable characters in this row. 

RA3 0000H Upper address set to zero assuming 
less than 64 kbytes of memory. 

RA, | XXXXH_ Address of character string 


positioning. 


RAs 


OOOOH ~—- Upper address set to zero 
RAg § XXXXH __ Address of matching attribute string 
RA7 0000H — Upper address set to zero 
RAg XXXX} Address of Row Redefinition Block 


Example of a RCB with 3 segments 


RAg  0000H Most significant bit is reset to 
specify that this RCB has no Row 
Redefinition Block 
RA; XXXXy ~~ Address of the next RCB 
RAg 0010,; ~~ Nohiddencharacters and 16 
- \ displayable characters in segment 1 
RA3 80001 Most significant bit to signify that 
more segments follow 
RAg XXXXy Address of character string of first 
: segment 
RAs 000014 Upper address set to zero 
RAg XXXXyj__— Address of attribute string ‘for first 
segment 
RA7 0020; No hidden characters and 32 
_.  displayable characters in segment 2 
RAg 8000); = Signifies more segments to follow 
RAg XXXXy_. Address of character string for 
second segment 
RA;q 0000, 
RA;  XXXX} = Address of attribute string for 
second segment 
RA;o 0014,; =Nohiddencharacters and 20 . 
displayable characters in third 
: segment 
RA;3 0000;; ‘Most significant bit reset to signify 
that the following segment is the 
last one 
RA;4 XXXX, ~~ Address of character string for third 
segment 
RAi5 . 0000) 
RAig XXXXy Address of attribute string for third 


segment 


Background ‘Row Redefinition Block and 
Window Row Redefinition Block: 


After power-up the CRTC requires at least one 
Background Row Redéefinition Block to initialize 
internal CRTC registers storing the character 
Additionally, when displaying win- 
dows, at least one Window Row Redefinition Block 
has to be provided after power-up. The CRTC 
does not reset these registers when displaying a 
new page; it overrides the contents only when it 
encounters a new Row Redefinition Block. How- 
ever, itis a good practice to add a Row Redefinition 
Block to the first Row Control Block of both, 
window and backgrou nd. . 


The maximum number of scan linas (TSLC + 1) is 
32. since the CRTC provides a 5-bit scan line 
address. The minimum value for the Total Scan 
Line Count (TSLC) is determined by the height of 


a 


the character font. In order not to truncate a part of 


the displayed character TSLC should be at least 
equal to NCE (Normal Character End). NCE minus 
NCS plus 1 (NCE —'NCS + 1) equals the actual 
height of the character but it does not start on the 
first scan-line unless NCS = 0. | 


Example of a Row Redefinition Block 


“data structure. 


Windows are rectangular. blocks of text that overlay 
the background without altering: the background 
The. background remains intact 
when the overlaying window is removed. When 
compared to a _ software implementation of 
windows, this hardware approach eliminates the 
modification of the display linked-list when display- 
ing or removing windows. Window boundaries can 
be defined as large as the entire display screen, or 
as small as one character in width. When. 
displaying windows, the user must take into consi- © 
deration that the window boundaries fall on 
segment boundaries of the background. Conse- 
quently, a heavily segmented background row - 


‘increases the number of choices of window 


TSLC = OD}; Rowheightis 14 scan lines 
NCS = 02,; Characters are displayed on the NCE 
= OAY = Srdthrough1ithscanlines ~ 

SPCS = 00}, . Superscripts are displayed on the 

SPCE = 08}; . 1st through 9th scan lines 

SBCS = 044, Subscripts are displayed on the 

SBCE = 0C}; © Sththrough 13th scan lines 

CURS= OB Cursoris displayed onthe 12th 

= Ss and 13th scan line 

DR = 004 Normalcharacter row 

UND = 0Cy Underline is displayed on 13th 
scan line 

SUND = 01;; Shifted Underline on 2nd scan 
line (over bar) 


o 


The two Row Attributes (10 bits) are not processed 
internally; this word is output during horizontal 
retrace to extend the attribute ewes of the 
CRTC. 


Attribute Processing 


If a row displayel does not contain any attributes 
then the CRTC.will not examine the attribute 
addresses in that row's RCB. Otherwise, these 
attribute, addresses contain the starting location of 
the attributes list for that row. The attribute codes 
accessed by the attribute address should appear 
in the order the attributes are referenced. For ex- 


ample, if the 1st character ona particular row is a Su-: 


perscripted, the 2nd character is a subscripted, 
and the 3rd character underlined then the attribute 
string should be 0010; (superscript), 00084 (sub- 
script) and 0002, (underline) respectively. Note 
that the attribute string might be shorter than the 
character string since attribute can be fetched on a 
demand basis. Refer to Chapter 3.5 for details. 


x’ : 
3.4 BACKGROUND AND WINDOWS 


There are two. independent linked-list data 
structures that describe background and windows. 


placements and sizes. If the sum of the number of 
visible characters for a row is less than the window 
size specified in the Window Definition Block, the 
window row will be filled by the fill character code. 


The rule for placing multiple windows on the 


screen is: 


¢ Windows must be separated vertically by at least 
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two background rows for non-interlaced mode, 
and three background rows for interlaced or RFI 
modes. , 


Figure 3.1 shows the linked-list structure for a multi- 
window display. The Top Of Window Hard Regis- _ 

ter (TOWH) points to the Window Definition Block 
(WDB) of the first (topmost) window. Each WDB 
links to the WDB describing the window below. 
The WDB for the window on the bottom of the 
screen (here: the third WDB) contains a pointer set . 
to zero, specifying that the current window is the 
last displayed window. If no window is to be display- 
ed, TOWH is set to zero. Additionally, each WDB 
contains the pointer to the first Window Row 
Control Block (WRCB). A WRCB has asimilar struc- 


‘ ture as a background Row Control Block (RCB). To 


add or delete a window, the user simply changes 
the next WDB pointer in the desired Window 
Definition Block. 


Non-Aligned Windows 


lf a window is not aligned to the segment boun- 
daries of the background, a forced alignment will 
occur after each re-link. This forced alignment 
affects the background segments overlayed by 
the window. Some example for forced alignment 
are illustratedin Figures3.2to3.6. = | 


S-€ 


ecu Figure 3-1 Window Linked-List Architecture 
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Background/Window Strategies 


The flexibility of the window linked-list structure 
allows the placement of a window anywhere on the 
screen, provided that the constraints mentioned 
earlier in the chapter are met. The user can use 
the flexibility; of the window placements to 
implement a split screen format, or a display 
containing virtual side by side windows. 


A split screen format can place two equal-size texts 
“on the screen, simultaneously, one in the window 
and one in the background. This feature is useful 
for character searching, comparing, and other text 
processing purposes. “Figure 3-7 shows examples 
of split screens. 


The window placement rules specify that two 
windows must be separated vertically by two or 
three background rows. However, virtual windows 
can be placed side by side. Figure 3-8 shows an 
example where the screen is divided into four 
quarters. Any one of these four windows can be 
scrolled independently. Virtual side-by-side 
windows give the illusion that windows can be 
adjacent to each other by redefining background 
and windows via the control block structure. 


Examples of virtual side by side windows 


The screen in Figure 3-8 is composed of two rows, 


the Window Definition Block (WDB). 


The WDB > 
links to the segment to be scrolled. : 


To enable scrolling of the scene FOUR, the 
pointer in the WDB linking to the WRCB linked list 


needs to be modified (Figure 3-10). 


3.5 ATTRIBUTES 


The CRTC supports nine character attributes such 
as: Cursor, Blink, Underline, Shifted Under- 
line/Strike Through, Subscript, Superscript, Re- 
verse, Highlight, and Ignore’ Character. Four 
additional attribute bits are user definable. One 
attribute bit specifies whether this attribute is 
latched or unlatched. The total number ‘of four- 
teen attribute bits are stored in the sixteen-bit 
attribute word fetched on a character basis. The 
four user-definable attributes are predefined 
attributes; except for the Ignore Character and 
Cursor attribute (Do-Dy9 of the attribute word) 
which may be put out on the Attribute Port lines 
APo-AP19 respectively. 


To maximize the flexibility of attribute processing, 
the internal attribute processing of the CRTC can 


‘be disabled. This gives the user up to 11 user- 


definable attributes. 


consisting of a total of four strings: ONE, TWO, 7 
THREE and FOUR. These strings (segments) can 


be placed anywhere in the system memory.. Two 
Row Control Blocks (RCBs) link the segments 
together. 
‘ t 

Each segment is also pointed to by a Window Row 
Control Block (WRCB). To be able to scroll a 
particular segment, this segment must first be 
defined as a window. Figure 3-9 shows the linked 
list configuration for scrolling the segment ONE. 
Window display is enabled by changing the Top Of 


Window Register (TOW) from “0” to the address of 


SEGMENT 1 


The internal processing of 
the five attributes (Blink, Underline, Shifted 
Underline/Strike Through, Subscript, and Super- 
script) is controlled by the Attribute Redefinition © 
Register. The Attribute Port lines themselves are 
controlled by the Attribute Enable Register. This 
register allows the disabling of the output of — 
particular attributes; the line becomes Low. 


_ A-character may have any combination of these’ 


SEGMENT 2 


attributes. The only exception is that one char- 
acter cannot have both the superscript and sub- 
script attribute. 


~ The number of hidden characters (Hidden #) in the | 


Row Control Block or Window Row Control Block - 


SEGMENT 3 


WINDOW 1 
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Figure 3-2 The Original Aligned Structure 


3-6 


SEGMENT 1 SEGMENT 2 * SEGMENT 3 


WINDOW 1 
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_ Figure 3-3 The left boundary of the window is drawn Inward. The front portion of Segment 2’s 
| data will appear in the gap not covered by the window. 


SEGMENT 1: SEGMENT 2 SEGMENT 3 


| 
I. 
el 


WINDOW 1 
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Figure 3-4 The right boundary of the window is drawn inward. The data from Segment 3 starts 
immediately after the window and part of the previously invisible Segment 4 becomes visible. 


SEGMENT 1 SEGMENT 2 SEGMENT 3 


WINDOW 1 


SEGMENT 3 
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Figure 3-5 The right boundary of the. window is extended outward. The extended portion of 
the window will inhibit the loading of Segment 3 into the line buffer and.? 


SEGMENT 1 SEGMENT 2_ SEGMENT 3 


“WINDOW 1 
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Figure 3-6 The left boundary of the window is extended outward. The extended portion of the 
window will overlay some of the right portion of Segment 1’s data. 


\ 
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| 
- must account for the characters in the segment 
~ with the Ignore Character attribute set. The CRTC 
needs this information in order to overlay windows 
correctly. For debugging purposes, the ignored 
characters can be displayed by setting the DH-bit 
(Display Hidden DH=1) in Mode Register 1. 
Displaying ignored characters in a segment will 
increase the number of displayable characters in 
the segment. This may cause windows to overlay « 
incorrectly. ~ 


Attribute Invoking | 
The CRTC supports a demand attribute fetch to 


save memory space and to reduce the bus 
occupancy of the CRTC. The CRTC scans the 


WINDOW BACKGROUND 





fetched characters. for attribute invoking char- 


_ acters. A character is an attribute invoking charac- 


ter when it matches the Value programmed in the 


Attribute Flag Register. Each time a match occurs _ | 


an attribute word is fetched from the attribute 
string. Certain bits of the character code can be 
masked off by the Mask, programmed in the same 
register. The CRTC supports three basic options 
as shown in Figure 3.11. os 


In the straightforward Option 1, each character 
invokes an attribute. In this case, the Latch- 
ed/Unlatched: attribute is ignored since latched 


_ attributes apply only to characters not invoking 


attributes. To enable this scheme, the Attribute 
Flag Register is programmed with 00xx,, where “x” 
is a “don'tcare.” 


- 


WINDOW 


BACKGROUND | 
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Figure 3-7 Horizontal and Vertical Split Screens: 
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Figure 3-8 Split Screen with four Windows 
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Figure 3-9 Scrolling Window “ONE” 
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In Option 2, only the characters with the most 


significant. bit of character code set invoke an 


attribute. Therefore, the Attribute Flag Register is 


programmed with 80801. A Mask of 80} specifies . 


that only the most significant bit of the character 
code must match the most significant bit of the 
Value (here: “1”). The attribute invoking character 
is displayed if the Invisible Attribute Flag in Mode 
Register 1 is not set. If the Invisible Attribute Flag 


is set, the attribute invoking character is not — 


displayed and the fetched attribute applies to the 
next character. | 


In Option 3, only one specific character code (the 
Flag) invokes an attribute. The Invisible Attribute 
Flag is set to disable the display of these 
characters. The Mask of the. Attribute Flag 
Register is loaded with FF, to specify that the 
character code must match exactly the Value to 
invoke an attribute. To program the character code 
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10}, tobe the Flag, the Attribute Flag Register is 
loaded with.FF10,. 


Certain attribute port lines may be disabled (they 
stay Low) by loading a pattern into the Attribute 
Port Enable Register. For example, a value of 
607Fy in the Attribute Port Disable Register will 
enable all the predefined attributes and disable all 
the user-definable attributes. The _ internal 


‘processing of the predefined attributes may be 


disabled by using the Attribute Redefinition 
Register. This yields up to 11 user-definable 
attributes. The predefined attributes Reverse and 
Highlight are not processed internally, so they can 
be treated as user-definable attributes. | 


Video System Controller (Am8152A). To: display 


the attribute invoking character, the JAF-bit in 
Mode Register 1 must be reset. 





Figure 3-10 Scrolling Window “FOUR” 


Characters 


Option 1 


' Option 2 


Option 3. 
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Attributes 


One-For-One 


128 Character Codes, 
Change of Attribute 
\ 


255 Character Codes, 
Change of Attribute 


Figure 3-11 Attribute Fetch Options 


The — 
- processing of these attributes takes place in the 


§ 


_Latched and Unlatched Attributes — 


A latched attribute applies to the attribute invoking 
character and all subsequent characters not 
invoking attributes. Latched attributes are not 
affected by window/background boundaries or 
screen boundaries. This means that the latched 
attributes in: windows carried over to the back- 
ground will carry over to the next frame. To avoid 


strange results in processing attributes, it is a good; 


practice to have a latched attribute for the first 
character of teacn Seger: 

Examples of attribute processing 

The characters A aid B invoke attributes. 


The display isACCCBDDD. 


“A and B both 


invoke unlatched underline 
attributes (0002}1) | 


ACCCBDDD 


A invokes a latched underline attribute (80021), B 


invokes an unlatched superscript attribute 
(0010},). - | 
~accc®ppp 


A invokes.a latched underline attribute (800211), B 
invokes a latched superscript attribute (80101). 


ACCCBDDD 


; , 


A invokes a latched underline attribute (8002,)), B- 


invokes a latched null attribute (8000}). 

| ACCCBDDD 

A invokes a latched underline attribute (80021), C 
invokes a latched null attribute (8000.4), B invokes 
a latched underline attribute (8002,,), 
invokes latched null attribute (8000). 


ACCCBDDD 


The FAT-Bit 


Setting the FAT-bit (Fill Code Attribute bit in the 
Main Definition Block) will cause the CRTC to fetch 


an attribute for the first Fill Code character in a Fill © 
Code string. If the Fill Code attribute is unlatched, © 


then it only applies to the first Fill Code character. If 
the Fill Code attribute is latched, then it applies to 
the whole Fill Code segment. The first valid 


character after the Fill Code segment should 


and D: 


unlatch the ‘previously latched attribute; this pre- 
vents the attribute from peng eae past . the 
Fill Code eeamo: | 


The CRTC loads Fill Code shaaciere: into its 
internal row buffer if either one of the three 


conditions below is true: 


e The character bas pointer of a segment is zero; 
the CRTC will fill the current segment with Fill 
Code. The size of the segment is defined by 
Visible #. The Fill Code Attribute is fetched from 
the address defined by the Attribute Pointer. 


The. total number of characters fetched for a 
window is less than the horizontal width of the 
window (End Window Character #-Start Window 
Character #). The remaining part is filled with the 
Fill Code. The CRTC increments the current 
attribute pointer to fetch the Fill Code attribute; 
this means, the Fill Code attribute follows the last 
fetched character attribute. 


e The total number of characters fetched for a row 


is less than that defined by the SLIM-bit in Mode 
Register 1 (96 or 132 characters). The remain- 
-ing part is filled with the Fill Code. The Fill Code. 
attribute is fetched from the location following. 
the last fetched character attribute. 


3.6 VERTICAL SMOOTH SCROLL 


Vertical Smooth Scroll moves the text in fraction of 
rows up or down; the effect is more eye-pleasing 
than hard scrolling. The number of scan lines the 
text is moved per frame is programmable in 16 
steps. The programmable rate ranges from very 
slow motion, where the viewer sees the text 
jumping in steps of scan lines (lowest rate), to a 
scroll rate where the text moves faster than the 
eyes of the viewer can follow (highest rate). » 


_ The CRTC performs smooth scrolling by adding a 


variable offset to the initial scan line count of the 
top. most row. The offset is. decremented or 
incremented, on a frame basis, for scrolling up or 
down, respectively. For example, if the scroll rate 
is one scan line per four frames, then the CRTC will 
scroll the text one scan line in one frame and waits 
for three frames before scrolling another scan line. 
In this manner, each character row appears to 
move upward smoothly, as opposed to the jerky 
motion of hard scrolling. The CRTC controls the 
smooth scroll process with minimum CPU 
intervention. The CPU only needs to update the 
linked list each time an entire row is scrolled in or 


out. All other operations that take place are 
transparent to the user. 
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The . background and windows can each scroll 


independently, but not simultaneously. Either the © 


background or window(s) can scroll at any given 
time. When multiple windows are to be scrolled 
simultaneously they do:'so synchronously, with the 
. game rate, and in the same direction. The infor- 
mation on this type of scrolling is defined in the 
Main Definition Block. Windows can be scrolled 
independently by ‘enabling window’ smooth 


scrolling in the Main Definition Block and setting | 


the Smooth Scroll Window bits. in. the Window 
Definition Blocks of the windows to be scrolled. 


Smooth Scrolling Up and Down 


Flipping between two Main Definition Blocks 
(MDBs) or two Window Definition Blocks (WDBs), 
when scrolling background or windows, avoids 
screen flickering caused by scanning partially 
updated definition blocks. The Top of Page/Win- 
dow Smooth Register alternately points to two 
_ different definition blocks. The CPU always up- 
dates the definition currently not processed by the 
CRTC. On relink request, the CPU toggles the 
pointer in the Top Of Page/Window Smooth Regis- 
ter. Initially, the TOPS/TOWS Register points to 
the definition block linking to the Row Control 
Block (RCB) of the topmost row. Figure 3.12 
illustrates this process. 


Background and Window Smooth-Scroll 


To smooth-scroll the background, only the scroll 


bits in MD, of the Main Definition Block need to be - 


set. To smooth-scroll a window, the scroll bits in 
MD, and the SCW bit in the scrolling window's 
definition block must be set. When a background 
text is scrolled past a window text, acommon TSLC 
must exist between the window. row and the 
background row that it overlays (Figure 3.13). If a 
background row is scrolled past a window row with 
their TSLC being unequal then distortion to the 
display will occur. 


It is essential that for any scrolling activity, the 
TSLC in'MDg of the MDB must be equal to the 
TSLC of the first RCB. To scroll a background-only 
dis- -play with variable TSLCs on each row, the 
TSLC in MDg of the MDB must be equal to the 
TSLC of the’ top-most row. Consequently, MDg 
must be constantly updated while the background 
is scrolling. The update of MDg must occur before 
the new pointer is written to the Top of Page 
Register. | 


The interaction between the CPU and the CRTC 
may be coordinated using one of three tech- 
niques: polling, non-vectored HEM, or vec- 
tored interrupt. 
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’ that it is done. 


Polling 


‘The CPU may test the IPS-bit (Interrupt Pending 


Smooth-Scroll bit in Mode Register 2) frequently to 
verify the time when the CRTC requires CPU 
intervention. The CRTC issues two types of inter- 
rupts (setting the interrupt pending bit) distin- 
guished by the Scroll In Progress bit (SIP-bit in 
Mode Register 2). When the SIP-bit is set on 
interrupt the CRTC likes to have the Top Of 
Page/Window Smooth Register updated. When 
the smooth-scrolling is finished, the CRTC. issues 
an interrupt with the SIP-bit reset to notify the CPU 
After servicing the requested 
action, the CPU must reset the interrupt ae 
by software. 


Non-Vectored Interrupt | 


A less time- -consuming and more efficient way of 
requesting CPU interventions is to use hardware 
interrupts. If the Interrupt. Enable Smooth-Scroll bit 
(IES-bit in Mode Register 2) is set the CRTC will al- 
so activate the INT line each-time the IPS-bit is set. 
The INT lirie may be connected to the non-vector- — 
ed interrupt input of the CPU or to a dedicated 
interrupt controller such as the 8259A or Am9519. 
In the end of the interrupt service routine the IPS- 
bit must be reset to enable further interrupts. 


Vectored Interrupt 


The most elegant way of synchionizing CPU inter- 
ventions is to use vectored interrupts. Therefore 
the No Vector bit (NV of Mode Register 2) must be 
reset. Similar to non-vectored interrupts the CRTC 
also activates the INT line when IPS-bit is set. 
When the CPU acknowledges the interrupt by as- 
serting the INTACK line the CRTC strobes out an 8- 
bit interrupt vector. Usually, this pointer addresses 


._ indirectly via a vector table the interrupt service 


routine. Bit 1 of the interrupt vector reflects the 
status of the SIP-bit so that testing the SIP-bit in. 


* the interrupt service routine becomes obsolete. 


The CPU may execute different interrupt service 
routines for both types of interrupts. Asserting the 
INTACK line also sets the Interrupt Under Service 
Smooth Scroll bit (IUSS-bit in Mode Register 2). 
Note, that unlike the implementation in some 
Z8000-type peripherals the interrupt acknowledge 
does not reset the interrupt pending bit. Both the 


-1PS-bit and the IUSS-bit must be reset by software 
inthe end of the interns seivice routine. ‘ , 


3.7 EDITING THE LINKED-LIST 


All text data is organized in a linked-list structure . 


simplifying editing tasks. The host CPU only 


needs to modify the pointers in order to swap 
pages, insert. lines, delete lines, or display 
windows. Pages can be swapped simply ‘by 
reloading either the Top of Page Register pointer 
or the pointer in the Main Definition Block linking to 
the top most. row. Since the pointers have both an 
upper and a lower part (two 16-bit values), a 
problem arises when the host CPU has to update 


| both for a new pointer value; the CRTC might use . 


a partially updated pointer in the case where the 
CPU has loaded only either the upper or lower 
pointer, and the CRTC gains the bus mastership 
right after this load. This problem occurs when 








SCROLLING UP ONE LINE 
enn at 


SCROLLING UP ANOTHER LINE 
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updating both pointers in Top of Page/Window 


Register or the pointers in Main Definition Block. - 


Row Control Block Memory 

The user can prevent the problem by 

synchronizing the host CPU updates with the 
CRTC linked-list scanning, via the vertical interrupt 
feature. For example, the vertical interrupt may be 
set to occur after loading the first row to signal that 
the Main Definition Block may be modified without 
any risk of running into the above mentioned 
problems. If only the lower part of the pointers is to 





Figure 3-12 MDB Swapping Simplifies Scrolling 
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‘be modified, the problem does not occur; pointers 
can be modified at any time. 


Row Insertion ; 


First, link the new row to the subsequent row (Step 
1 in Figure 3.20), then link the previous row to the 
new row (Step 2 in Figure 3.20). When operating 
only with the lower half of the pointers, this type of 
modification can be done, at any time; without any 
concern of synchronization to the CRTC 
operation. . 


~ Row Deletion 
A row is deleted simply by linking the pointer in the 


previous Row Control Block to the next Row 
_ Control Block (Step 1 in Figure 3.21). 





Character Code and Attribute Pointers 


The least significant bit of the linked-list pointers in 


.registers or memories is “don't care.” The CRTC 


resets this bit when operating with the pointer. 
Consequently, all addresses put out by the CRTC 
are even. Since characters are 8-bit quantities 
which can be located at either odd or even 
addresses, the user has to take into consideration 
that character code strings always start at even 
addresses. This might become a restriction if the: 
background characters are stored in a linear list and 
this.list has to be split up into segments in order to 
overlay windows. Since the character code 
pointers are always even, the background list can 
be split only at even addresses. The number of 
choices can be increased by interleaving 
characters with the Ignore Attribute Set. 


BACKGROUND 
BACKGROUND TLSC 
MAY VARY 
_ BACKGROUND TLSC 
WINDOW = WINDOW TLSC 
BACKGROUND TLSC 
MAY VARY 
SOFT SCROLLING WINDOWS. 
BACKGROUND 
ace BACKGROUND TLSC 
WINDOW |: = WINDOW TLSC 





SOFT SCROLLING BACKGROUND 
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Figure 3-13 Background rows overlayed by window 
must have the same TSLC than the window rows. 
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Figure 3-14 Flowchart for scrolling up the background using vectored interrupts 
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SMOOTH SCROLL INTIALIZATION SUBROUTINE 


FLAGe~ 0 








CALL SOFT 


SCROLL © 
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EXECUTION INTERRUPT IN CPU 


INTERRUPT ENABLE 
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INTERRUPT 
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VERTICAL 
INTERRUPT 


TERMINATE 
SCROLLING 
ROUTINE 


SSE IN 
MDBO0<—~ 0 


Figure 3-15 Flowchart for scrolling up the background using non-vectored interrupts 
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Figure 3-16 Stop scrolling up of the background after N lines 
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SCROLL INTIALIZATION | ! : 
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Figure 3-17 Stop:scrolling up of a window after N lines 


SCROLL INTIALIZATION : START SCROLL 


CLEAR IPS BIT IN 
MODE 2 
. / 
FLAG <0 
NO SCROLL¢- 0 


MDB1<— ADR OF 
NEXT TOP RCB 


TOPS<—MDB1 | 


fi i 


SET SSE IN MDBO 


f] 


a 


LINE #<— 0 


READ MODE 2 


RESET SUD AND 
SWB IN MDBO AND 
MDB1 


—-------—-------------- - - + 44. 





Ges ees te 0 Si Ste aa eet os reac 


of 


YES 


CLEAR IPS BIT 


EXIT ROUTINE 


FLAG 1 


< 
m 
n 


» 
Le 
’ 


i fi 
oO . 
wo } (i 
3 O 
= 7 
m 
7) 









| FLAG 1 we 
LINE#¢ LINE# +1 me LINE#<—LINE# + 1 
YES RESET SSE IN YES “RESET SSE IN 
. | MDBO 
. MODIFY LINK NO SCROLL<— 1 MODIFY LINK NO SCROLL¢— 1 
IN MDB1 IN MDBO ae . 


TOPS< MDB1 | TOPS<— MDBO 


Oy. | a oo -05098B 3-18 


Figure 3-18 Stop scrolling down of the background after N lines 
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Figure 3-19 Stop scrolling down of a window after N lines 
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ORIGINAL CONFIGURATION ROW INSERTION 
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Figure 3-20 Pointer manipulation inserts ROW . 





ORIGINAL CONFIGURATION ROW DELETION 
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Figure 3-21 Pointer manipulation deletes ROW 
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CHAPTER 4 


VIDEO SYSTEM APPLICATIONS 





4.0 INTRODUCTION 


This chapter outlines three system applications of 
the .Am8052 and the Am8152A. _ The first 
application describes a typical design with 8 pixels 
per character.and a 40 MHz pixel rate. In the 
second application, the character width is increas- 
ed to 12 pixels and it will be shown how the 9-bit- 
wide input of the Am8152A is multiplexed-to load 
the wider character slice. The third application, 
proportional-spacing, discusses pipelining of the 
data flow, which becomes necessary at high 
character clock rates. 


4.1 TYPICAL APPLICATIONS 


Figure 4.1 shows a non-proportional spacing - 


application operating the video system at 40-MHz 
. pixel rate. The character matrix is 7 x 9 pixels ina 
character cell of 8 x 14 pixels. The rightmost pixel 
is blanked. The Character Clock defining the rate 
of characters being shifted out can be determined 
by dividing the pixel rate by the horizontal width of 
the character cell: 


40 MHz/8 = 5 MHz. 


Since this video system employs only a single 
Video System Controller (VSC), which does not 
need to be synchronized to an external dot clock, 
the internal crystal oscillator can be used. The 
crystal frequency can be determined as 


40 MHz/5 =8 MHz. 


Since the CLK» frequency is constant, the Clocks 
Divide Ratio inputs (CLK»DR<3:0>) may be 
hardwired to High or Low, respectively, instead of 
generating new values on a character-by- character 
basis as in the case of proportional spacing. Since 
~ no trailing blanks are used, TB<1:0> are tied Low. 
The formula for calculating the appropiate Clock» 
Divide Ratio is shown below: 


N=n+IB+2 


Number of pixels/character 

CLK»DR programming 

Number of Trailing Blanks 

adjust range to 2..17 pixels/character 


N 
n 
TB 
2 


", (MCLK5). 


the character matrix is 7-bits wide horizontally, 
inputs DD7 and DD8 can be grounded. The 256 
different characters are addressed by the 8-bit 
Character Code (usually an ASCII code). The 14 
scan lines, per character cell, are addressed by the 
4-bit Scan Line Address. Altogether 12 bits are 
used to select a particular character slice, which 
implies using an 8K x 8(7)-bit Character Font 
Generator (usually ROM, PROM, or EPROM). 


A 5-MHz CLKo translates to a 200 ns character 
clock period. The following calculation shows how 
the maximum allowable data:'access time for the 
Character Font Generator is determined. The 
Am8052 strobes out the Character Code 
(CC<7:0>), and Scan Line Addresses (R<4:0>) 
with a propagation delay to the Character Clock 
The character slice data addressed 
needs to-be valid before the next rising edge of 
the Character Clock to allow the VSC to latch it. 
Therefore, the propagation delay of the Am8052 
plus the maximum access time of the Character 
Font Generator plus the set-up time required by 
the VSC must be less than one character clock 
period. Assuming the Am8052 propagation delay . 


- from MCLK» to CC and R is 55 ns (6-MHz spec), 


In this example, “‘n” becomes 8 —- 0 —- 2 = 6. Since: 
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and TCLK»s to MCLKo delay is 8 ns, and the set-up 
time required for the data to TCLKo is 20 ns, the 
maximum access time becomes: 


200 ns—55ns-—8 ns—20 ns=117ns. 


Am27S43 (4K x 8) PROMs ama this requirement 
(55 ns maximum). 


4.2 MULTIPLEXING THE DATA INPUTS 


This application features a system of 12-bit-wide, 
non- proportional spaced characters at 60-MHz dot 
rate. Itis illustrated in Figure 4.2. Similar to Figure 
4.1, the on-chip crystal generator can be used to 
generate the Dot Clock. The crystal frequency is 
60 MHz/5 = 12 MHz. The inputs specifying the 
number of Trailing Blanks to ‘be added are 
grounded (no Trailing Blanks). Having a non- 
proportional spaced set of characters means that 
there is no use for the nee Blanks; therefore, 
their inputs are grounded. . 


The CLK» Divide Ratio inputs are hardwired to” 


‘High and Low to provide a constant divide ratio. 


The Dot Clock is divided by 12 to generate the 


Character Clock. The inputs are programmed as: . 


12-0-2=10(1010p). 

Given the 60-MHz dot rate and the 12-pixel-wide 
character cells the CLK» frequency can be 
calculated as : 


CLKp = 60 MHz/12=5 MHz. 


The character clock Period becomes 200 ns. 
Since the character cell is wider than the data input — 


path of the VSC, the data must be pipelined. With 
the rising edge of the clock, the right 9 pixels are 


loaded. DDO is the rightmost pixel. With the next 
falling edge of the clock, the VSC latches the left 8 
pixels. In this application, only 3 bits are loaded 
with the second clock edge. 7 


The CRTC outputs the Character Code: (CCo_7) 
and Scan Line Addresses (Ro_4) with a propaga- 
tion delay of 55 ns to the rising edge of MCLKo. 
The maximum skew between TCLK;, and MCLK, 


. are 8 ns and 12 ns for rising and falling edges 


respectively. Similar to the application shown in 
Figure 4.1, the maximum allowable access time is: 


200 ns—8ns—20ns—55 ns=117ns. | 





_ SYSTEM CLOCK 





Am27S43__. 
4K x8 : 


ANALOG GROUND 


DIGITAL GROUND 
(GND,) » (GNDo) 





CRT 


MONITOR 
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- Figure 4-1 Non-proportional Spacing System | 


Since PROM B has to present the data at the 
inputs of the register with a set-up time of 2 ns 
(Am29821 parameter), the access time of PROM B 
can be calculated as: 


200 ns—55ns—8ns—2ns=135ns. 
The multiplexing of the data is as follows: 
The CRTC outputs the character and scan line 
information for the characters synchronously to 


MCLK»y. The Character Code and the Scan Line 
Address select a particular character slice. Since 


SYSTEM CLOCK 


the VSC expects 9 bits of data on the rising edge 
of TCLKs, and PROM A supplies only 8 bits, 
PROM B provides the 9th bit; it is connected to 
DDg.: Enabling PROM A with TCLKo ensures that 


_ the first 8 bits are present at the VSC data inputs 


prior to the rising edge of TCLK>. PROM B is 
permanently enabled, therefore, the 9th bit is 
available at the rising edge of TCLK> but is ignored 
on the falling edge. The remaining 3 bits (12-bit 
character width) are loaded on the falling edge of 
TCLKs at which time the Am8052 has already 
selected the next character. Therefore, the output 


_- Of PROMB has to be registered (Figure 4.3). 
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Figure 4-2 Multiplexed data path to load wider character slices 


4.3. CHARACTER PIPERINING: 


At high character clock rates, or in aptonanional: 
‘spacing applications, the. character data path 
needs to be pipelined to relax, as much as 
possible, the access time requirements for the 
Character Font Generator. Assuming a 8-MHz 
clock rate and taking the approach of the examples 
in Figure 4.1. and Figure 4.2 would require an 
access time of: 


125 ns— ‘8ns- 45 ns — 20 ns = 52 ns. 


_ The following analysis points out how this access 
time can be relaxed (Figure 4.4). 


The clock to output delay of the Am29821 register 
is specified at 12 ns. The set-up time is 2 ns. This 
calculates a worst case access time of: 

— 125 ns—12ns—2ns=111ns. 


Pipelining both input and output data gains about 
50 ns (Figure 4.5). , 


If only the input data is pipelined than the 
requirement becomes: 


 425ns—12 mie ns = 93 ns. 





This appioaen still gains 41 ns. 


The CRTC allows programming the skew between - 


Character Code and Attribute output .or Control 
Signal (HSYNC, VSYNC, and BLANK) output. 
(See Mode Register 1 description in Chapter 2) 
This skew can be used advantageously in this case 
by advancing the Character Code. and Scan Line 
Address by one or two CLKo cycles so that the rest 
of: the signals do not need to be. pipelined 
ey sir | 


4.4 | CHARACTER/SYSTEM CLOCK 
SYNCHRONIZATION | 


In proportional-spacing applications, the Character 


_ Clock-defining the Character Output Rate and the 


System Clock defining video timing (VSYNC; 
HSYNC, BLANK) must be synchronized at the left 
edge of the display in order to avoid a jagged 
edge. The VSC synchronizes both clocks when 
the SSEL (Synchronization Select) is tied High. If 
SSEL is Low, no synchronization occurs. 


Synchronization ensures that HSYNC and BLANK 
change synchronously to CLK», resulting in a 
straight and smooth left border of the display. The 
right edge of the screen also is straight and 


be. 300 nsee >| 
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Figure 4-3 . Multiplexed character data timing: | 


) 


nTH CHARACTERS 


“ 05098B 4-3 


oaeaameatn me 


4-4 


smooth since the width of the display is a multiple 
of the fixed-rate System Clock (CLK;). Note, that it 
is the system designer's responsibility to ensure 
that the last characters in any line are blank, so a 
valid character is not truncated due to the 
asynchronism of CLK, and CLK» at the end of a 
scan line. : 


The synchronization process of CLK; and CLK» 
takes place in the beginning of HBLANK. The 
VSC holds CLK» Low. for several CLK, cycles then 
toggles in’ phase to CLK, until it recognizes 
*HBLANK going Low (inactive). From then on 


SYSTEM CLOCK 


CLK» is generated as controlled by the divide ratio 


inputs. 


Additionally, the VSC delays HSYNC and VSYNC 
so that they change synchronous with the. Video 
Data (VID, and VIDs). The internal delay buffers 
are clocked by GLKa.when SSEL is Low, and by 
CLK; when SSELais High. Since these delays 


-match the video delay when SSEL is Low, these 


buffers can be used to latch any other video 
attribute the user might chose to use, in addition to 
the given.attributes (FS, BS, REV, etc.). 

























‘VSYNG 





Am27S43A 
4Kx8 


05098B 4-4 


MCLK, 














56 pF 
HSYNC + : 
BLANK C7 6.4 MHz 
\ Xo 
CBLANK 3002 . 
56 pF 
FORE i, 
Am8152A 

X3 

TBo 0.47pF 


_ GND2 


EXTDCLK 





CLK,DRo_ 
CLK,DR, 


‘4 


TCLK, 
DDo_7 
DD, 
-HSOLD VSOLD VIDi2 








~ Figure 4-4 Character pipelining in proportional spacing systems 
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4.5 CRYSTAL OSCILLATOR LAYOUT 


The VSC has two power supplies: a digital power 
_ supply (Veco, and GND) and an analog power 
supply (Voce ‘and GND»). This split enables the 
“system designer to keep the analog supply as 
clean as possible. A low-noise analog supply is 
essential for a reliable operation of the crystal 
oscillator and the  phase-lock-loop (PLL) 
multiplying the crystal frequency; especially if the 
operation of the PLL is a direct function of the 
noise-level on the supply. : 


The PC-board should be laid out in such a way that . 


the lines from the pins of the VSC to the external 
capacitors, resistors and crystal are as short as 
possible. These passive circuits are connected to 
the analog ground (GND»). 


4.6 HALF DOT SHIFT WITH THE 
Am8152A 


To increase the display quality, character slices can «. 


be shifted half a dot as shown in Figure 4-6. One 
character font bit enables or disables this feature. 
This bit is delayed by two D-flip-flops to compen- 
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Figure 4-6 Half Dot Shift 


sate for the delay in the Am8152A (Figure 
4-7). The AND-gates route the output of the 
Am8152A (VID2) either triggered flip-flop or to the 
negative edge triggered flip-flop. If Half Dot Shift is 
activated, the appropriate character slice is shifted 
half a dot to the left. ' 
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Figure 4-5 Pipelining Timing Diagram 
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CHAPTER 5 


GENERAL APPLICATIONS 





Some applications for alphanumeric CRT systems — | 


require a dynamically programmable character-set 
to be able to modify the character font, to add 
special characters used in some foreign langua- 
ges, or to provide semi-graphic characters. In this 
chapter, three application notes for the CRTC are 
introduced. These applications examples by no 
mean imply to cover solutions for all types of appli- 
cations; however, they serve to motivate desig- 
ners to use their imagination and creativeness in 
finding the ideal solution for his or her particular 
application design. 


5.1 LOADABLE CHARACTER GENERATOR 
FOR AN Am8052 SYSTEM 


This application note describes a Loadable 
Character Generator for an Am8052 based alpha- 
numeric -CRT system, implementing the unique 
approach when the Am8052 itself loads the 
character font. It assumes that the reader is familiar 
with the Am8052. For background information, 
refer to Section 2. An alternate approach is descri- 
bed in the chapter on low cost, smart terminals. 


There are two basic approaches to the design of a 
Loadable Character Generator: | 


(i) The “usual” way of designing a Loadable 
Character Font Generator (RAM) is to 
implement it as a dual-port memory where the 
CPU has direct access. An address multiplexer 
is then inserted at the Address Bus of the Char- 
acter Generator (CCop_7 and Ro_4), connect the 
output via a bus driver to the System Data Bus, 
and control both the multiplexer and the driver 
by arbitration logic. To prevent screen flicker- 
ing, the Character Generator should only be 
accessed during horizontal or vertical retrace. — 


The advantage of this approach is that the char- 
acter RAM can be read and written directly by the 
CPU. Also, the Font RAM can be altered rapidly. 


data bus of the Character Generator must be 
set up; a few additional TTL devices are need- 
ed to implement this feature. The Character 
Generator information is stored in the linked list. 


Advantage of this approach is the small amount of 
support logic required. 


The disadvantage is that more sophisticated 
software is required to control the loading process, 
and the character font cannot be read back. 


_ This application note focuses on the second 


approach, utilizing the Am8052 (Figure 5-1). 


A blank part of the screen is utilized to load the 
Character Font Generator. In the initialization 


_ phase, this space can be the entire screen; during 


to load -the Character Font Generator. 


The disadvantage is that a large number of TTL ~ 
support parts is required to build the two-port RAM 


control logic. 


(ii) The sacaielacnreatl utilizes the Am8052 for 
loading the Character Generator. Most of the 
pins of the Character Generator, are already 
connected to the Am8052. Only a path to the 
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display time, it may be a blank space at the bottom 
of the screen. The number of characters per frame 
which can be reloaded is elect proportional to 
the space allocated. 


The screen is divided into two parts (Figure 5-2): 
the visible part of the screen displays the normal 
text; ‘the invisible, lower part hides the rows used 
In this 
example, there are 18 scan lines at the bottom of 
the screen that are used to load a character box of 
7 XQ pixels. These scan lines are located between 
normal-vertical-blank active and. vertical-sync 


active. The rows are hidden by setting a user- 


definable Row Attribute Bit that externally blanks 
the video. Each character of the rows invokes an 
attribute word. As in the usual display mode, the 
character code addresses a character box in the 
Character Generator.. However, the purpose of the 
attribute word changes; now, it contains the data of 
the character slice to be loaded. 


Detailed Description 


The Am8052 provides user definable data during 
horizontal retrace. This data is stored as a row 
attribute word in the Row Redefinition Block. It can 
be latched with the falling edge of HSYNC. In this 
design, two bits are used to control the load 

operation. One bit blanks the screen to: hide the 
rows containing the Character Generator data; the 
second bit disables the Read input of ‘the 
Character Generator and enables the attribute bus 
driver. The bus driver connects the attribute port 
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Figure 5-1 Using the Am8052 to Load the Character Generator 
VISIBLE PART OF 
; THE SCREEN 
FIRST HIDDEN ROW 
(3 SCAN LINES) | 
TO LOAD UPPER - 
. PART OF CHARACTER 
oe | . ATTRIBUTE BLANKED 
. SECOND HIDDEN ROW (USED TO LOAD CHARACTER GENERATOR) 18 SCAN LINES 
‘ (6 SCAN LINES) : 


THIRD HIDDEN ROW 
(9 SCAN LINES) 


Figure 5-2 Screen Layout. 
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aay 


to the data bus of Character Generator. Since this 
design assumes a 7 X 9 character box, only 7 bits 
of the attribute are connected. to the Character 
Generator; the 8th bit is grounded at the input of 
the driver. Any character fonts size can be suppor- 
ted in order to accommodate design changes. . 


Two bits of the attribute port and the cursor output 
are used to enable the loading of specific character 
slices. These 3 bits have a common feature. The 
character part where these attributes are active is 
programmble ona character row basis. “Underline” 
-and “Shifted Underline” are active during one scan 
line in the character cell. The scan line number, 
where these two attributes are active, is specified 
in the Row Redefinition Block. The values can be 
changed on a row basis by specifying a Row 
Redefinition Block for each row. “Cursor”, is an 
attribute which is active during part of a character. 
“Start” and “End” values for this attribute is speci- 
fied in the Row Redefinition Block. If these values 
are identical, the attribute is active only during one 
programmed scan line (see Tables 1 and 2). 


The 3 attributes determine which slice of the 
selected character is loaded. The attribute string 
layout of Figure 5-4 assumes that the Row 
Redefinition Blocks contain the values of Tables 1 
and 2. Each attribute word activates one of these 
3 attribute bits to select a specific character slice. 
The character slice is loaded with the 7 bit value 
contained in the attribute word. Three consec- 
utive attribute words in which each activates a 
different attribute bit (Figure 5-4) so that the upper 
3 slices are reloaded in the end. In the next row, 
the row attributes are redefined to enable loading 
of the middle part of. the characters. A third row 
loads the remaining lower part. 


When one of the 3. attribute output pins is 
activated by the attribute word, and when a latched 
row attribute bit disables Read, then the Character 


_ | S 


Generator receives a Write pulse to Strobe in the 
character slice (Figure 5-3) | 


Seven attribute bits must be programmed in the 
Attribute Redefinition Register as user-definable 
attributes. .In this design, a maximum of 44 
characters-per-frame can be reprogrammed. This 
number is determined by: 


e The length of the row buffers (132 characters) 


e 18 scan lines are used for loading the Character 
Generator 


e Each character has 9 slices (9 character pos- 
itions in the row buffer). 


Modifications to support character font generators 
wider than 7 bits: 


Loading can be done in steps. A character box 
which is'12 pixels wide can be loaded in two steps, 
each loading 6 pixels. The 7th bit of the attribute 
now selects the left or right part. An alternative is 
to use a latched attribute bit (an output of the latch _ 
in Figure 5-1) to select the parts. Note that these 
attributes are constant in the entire row, therefore, 
different parts cannot be loaded if a latched 
attribute is used. 


Scan line count can be reduced when less 
attributes are used to select character slices. Note 
that the minimum scan line count of a row is 
determined by the time the CRTC needs to fill the 
row buffer. - | | 


An arbitrary number of attributes (“n”) are utilized to 


select slices. The first row loads the upper “n” char- 
acter slices and has a minimum scan line count of 
“n.” The second row loads the next “n” slices and 
has a scan line count of 2° n. A third row loads 
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Figure 5-3 Write Timing 


subsequent “n” slices and has 3 * n scan lines. In 
this example of a 7 X 9 character:box and 3 slice 
attributes, 2 rows are needed to load all 10 slices. 
The first row loads the upper 3 slices and contains 
3 scan lines, the second row has 4 scan lines and 
loads the middle 3 slices. The third row has 9 scan 
- lines and loads the lower 3 slices. - 


The “old” vertical blank active time must be repro- 
grammed to allocate space for the character-load 
rows. An attribute bit will blank this part of the 
screen so that there is no visually detectable differ- 
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ence on screen. 

Figure 5-5 shows. two 7 Xx 9 character cells con- 
taining an “A” and a “F”. Figure 5-6 shows parts of 
the linked list data strings specifying the data to 
load the character fonts of these characters. 


A7X9 character set of 256 characters fits into an 


‘8K X8 RAM. The maximum access time depends 
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on the resolution of the display ( 


high resolution => 
about 60 ns). | 
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Figure 5-4 Character and Attribute List 
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Figure 5-5 7x 9 Character Box 


5-4 


Table 1 Parameters for Row Redefinition | 
Block of 1st Row 





TSLC. = 4 The first row loads only the 
| upper five character slices 
NCS = O Normalcharacter start onscan| 
| ine O 
NCE = 4 Normalcharacter end onscan 
So fine 4 
CURS = OQ Cursorstart 
CURE -= 0 Cursorend 
UND = 1 Underline active online 1 
SUND = 2 Shifted underline active online 2 
Table 2. Parameters of Row Redefinition _ 
Block of 2nd Row 
TSLC = 9 Thesecond row loads the lower 
five character slices (scanning 
the first five lines a second time is an 
- unavoidable overhead) 
NCS = 0 Character position starts at 0 and 
NCE’ = 9 endsat9 | 
CURS = 5 Allothervalues are incremented 
by 5 to 
CURE = 5 access lower5 scan lines 
UND = 6 
SUND = 7 


5.2 HORIZONTAL SMOOTH SCROLL 


Vertical screen scrolling on standard terminals is 
done by replacing the text line by line; the text 
appears to jump up or down the screen. A more 
desirable and ergonomic approach is to smooth 
scroll the text. The Am8052 alphanumeric CRT 
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‘controller (CRTC) can achieve this effect by 


replacing the scrolled line on a scan line basis. The 
text moves in steps of line partitions (scan lines). 
This produce smaller jumps and is almost 
unnoticeable to the viewer; it appears to be a con- 
tinuous, smooth, upward or downward movement 
of the text on screen. The scrolling itself is exe- 
cuted without CPU interventions. 


In applications that involve displaying text running 


_ Off the screen horizontally requires scrolling the 


text accordingly. Once the user has experienced 


‘vertical smooth scroll, the demand for horizontal 


smooth scroll will come naturally. Similar to vertical 
smooth scroll, horizontal smooth scroll can be . 
done by replacing characters on a pixel basis. Al- 
though the CRTC does not have a built-in mechan- 
ism to control horizontal smooth scrolling, this appli- 
cation note provides some ideas for a practical im- . 


~ plementation. External MSI logic and CPU interven- 


tions are required to control the scrolling process. 


The basic idea behind this scrolling technique is to 


place a dummy character in front of the line. This 


Character is made invisible by delaying the 





PART OF 
“A” 


horizontal BLANK with external logic. The entire 
line is then moved by modifying the width of this 
dummy character, utilizing the proportional 
character capability of the Am8152A Video System 
Controller (VSC). The blank delay covers the en- 
tire dummy character when it is programmed for full 
width. By reducing the width of this character, the 
first visible character moves left and gets partially 
covered. Characters seem to enter the screen on 
the right side and leave on the left side. Figure 5-7 
diagrams the process. 
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Figure 5-6 Character Code and Attribute sequence to load “A” and “f” | 


Detailed HeseHBugn:. 


Here it assumes a non- =olepeilional spacing 
environment with a character width of 8 pixels, and 
a dummy character width of 10 pixels; there is no 
restriction to these values. External logic hides the 
dummy character and the first visible character by 
delaying BLANK (10 pixels). The delayed BLANK 
masks off the serial video stream. put out by the 
* WSC (Figure 5-8). 


By reducing the character width of the dummy 
character from 10 to 2 pixels in 8 steps, the 
leftmost character is moved out. The dummy 
character has to be wider than the widest visible 
character in order to hide a dummy character (2 
pixels minimuny width) as well as the’ leftmost 
character in the blanked space (Step 9 of Figure 5- 
7). The width of the dummy character can be 
controlled by using several methods described in 
the following paragraphs. Step 9 of Figure 5-7 is 
optional, it is shown to clarify the entire process. 
The user can expand the dummy character to its 


full size (10 pixels) when only one pixel of the 


leftmost character is left visible (Step 8 to Step 10). 


Horizontal smooth-scrolling can be made frame- 


~ synchronous by incorporating the Vertical Interrupt 


of the CRTC. This interrupt is issued once per 
frame. The scroll rate can.range from as low as one 
pixel per several frames to several pixels per frame. — 
This is similar to the programmable scroll rate for 
vertical smooth scrolling. For additional information 
refer to Section 2 of this handbook. | 


External Blanking 


One of the criterion for this application is to find a 
simple way of delaying BLANK to the appropriate 
number of pixels (example 10) to hide the dummy 
character. 


A practical approach is to delay BLANK by feeding 
it through two D-flip-flops clocked by the system 
clock CLK1. This requires CLK1 period to be 
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Figure 5-7 


larger than the character clock period (CLK2) and 


that CLK1 has the appropriate pixel width (Figures 


5-8 and 5-9). 


Another approach is to use a counter to delay the . 


BLANK for the appropriate number of pixels. The 
counter is to be clocked by the DOT Clock: and 
enabled by the first edge of CLK1 or CLK2, after 
BLANK active. The problem with this approach is 
that an external DOT Clock must be available. Most 









Am8052 


applications make use of the built-in PLL of the 
VSC and consequently an external DOT Clock in 
unavailable. : 


Width Control 


The width of the dummy character can be modified 
by using the proportional character display cap- 
abilities of the VSC. 


In proportional character 
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Figure 5-8 Delaying BLANK 
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Figure 5-9 Delayed BLANK Timing — 


on 


applications, where the character font generator 
already contains a set of characters with widths 
between 2 and 10, no special hardware is neces- 
sary (Figure 5-10). The CPU-changes the dummy 
character for each scrolling step. The new char- 
acter has either a decreased or increased width, 
depending on the scrolling direction. Decreasing 
the width causes a left scroll; increasing the width 
causes a right scroll. 
updated after scrolling an entire character. | 


- In proportional character applications, the user has 

to keep track of the width of the,character inserted 

or deleted when updating the row data list. The 

modification of the width of the dummy character is 

a function of the width of. the inserted or deleted 
character. 


In applications with a fixed character-width, it might 
be practical to add a character-font width generator. 
to implement a character set of different widths for 
the dummy character. 


Another approach in controlling the width of the 
dummy character is to include the bias of the row in 
the Row Attribute Word. This attribute word is put 
out during horizontal retrace, and can be latched 
by HSYNC (Figure 5-11). The character attribute 
_AP9 is only activated during scanning the dummy 
character to switch the multiplexer. The multi- 
-plexer normally guides the Character Font Gen- 
erator output to the VSC CLK2-Divider inputs. 
Only during scanning the dummy character the 4- 
bit width stored in the Row Attribute Word is used. 
This approach is advantageous when the linked- 
list contains only one Row Redefinition Block 
common to all rows. In that case, the CPU only has 
to update one word to move the screen hori- 
zontally. In the other approaches the CPU has to 


Am8052 


The row data list has to be 





update one character per row. 
5.3 BIT-MAPPED GRAPHICS WITH 
Am8052 — 


This section outlines a aeend Caspian in using 
the Am8052 for bit-mapped graphic. The design 
discussed in the reprints of magazine articles in the 
appendices dealt with graphic information stored in 
a special x-y addressed display memory. The 
linked-list interpreted by the Am8052 provides — 
only the address information and not the display 
information itself. The approach presented in this 
section involves linked-list providing all display 
information including the pixel data. The software- 
oriented implementation requires only one 
external 8-bit multiplexer (minimum configuration) 
whereas the hardware oriented implementation of 
the design outlined in the magazine article 
requires multiplexers, a separate display memory 
including refresh circuitry, and bus arbitration logic 
to let either the host CPU or the CRTC access the 
display memory. The advantages of this scheme © 
over the design shown in the magazine articles can 
be summarized as follows: 


e less stare circuitry 


e no dual-ported display memory, pixel and text 
data is stored in system memory 


However, this approach has some trade-off and 
limitations compared to the design in the ‘last 
chapter. 


e mixed text and graphics only on horizontally split 
screens (entire scan lines are allocated for either 
text or graphics) 


Am8152A 


CLKp 
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_ Figure 5-10 . Variable Character Widths 
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} 


~ e heavily increased system bus ‘utilization (up to 


100%) when displaying graphics, therefore dual- 
bus architecture appropriate 


Both designs provide the same resolution for text 


- and graphics (same dot clock). Both designs take 


advantage of the linked-list architecture of the 
CRTC system and thereby allow easy and fast 
page swapping, ‘block moves. Further: on, the 
graphic page can be vertically smooth Berle in 
both designs. 


Pixel Generation 


A standard CRT controller strobes out the 
character code (usually the ASCll-code for the 
character to be displayed) on a character clock ba- 
sis. This character code and the scan line address 
select.a particular character slice address in the 
character font generator. The character font 
generator then provides the character slice data 
which is serialized by the video shift register. 


In this bit-mapped graphic approach the character 
font generator is bypassed and the character code 
is shifted out directly. Since the character code 
can have any 8-bit pattern, it can define any slice of 
8 pixels. Since subsequent scan lines on bit- 
graphic displays are usually unique bit patterns, 
each scan line is described by its own sequence of 
character codes. This means that, in bit-mapped 
graphic mode, character rows contain only one 
scan line compared to a scan line count of 8..16 in 
text mode. Consequently, the bus utilization of 
the CRTC increases drastically. In fact, the screen 
resolution is limited by the data transfer capability 
of the system bus. 


CC/R 
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In bit-mapped graphic mode the Total Scan Line 
Count (TSLC) is set to 00,4 in the Row Redefinition 
Block (RRB) for the first graphic scan line. 
Additionally, one bit of the 10-bit row attribute 
switches the multiplexers to graphic mode. This 
row and all succeeding rows will maintain that 
attribute until another RRB is invoked by the linked- 
list of Row Control Blocks. In this fashion 
alphanumeric: and bit-mapped presentations can 


be intermixed onthe display device. 


Figure 5-12 shows the linked-list data structure 
upon which this application is based. For the 


‘rews/scan lines defined to be bit-mapped, the 


hardware will be made to display the 8 pixels per 
character slice directly out of the CRTC instead of 
using a character font memory as an indirect look- 
up mechanism. This switching mechanism is 
implemented with the row attribute information 
normally outputted by the CRTC during horizontal 
retrace. In this application only one bit is used to 
differentiate between text and bit-mapped graphic 
mode. The other bits can be used for other purpo- 
Ses such as implementing a soft loadable character 
font generator. 


The major design consideration is that the CRTC’s 
on-chip DMA controller is given enough bus time 
to complete loading the row buffers contained in 


' the chip before,the information is displayed. The 





CRTC must be able to load one character row in 
less than a horizontal SYNC cycle (one scan line). 
In the limit, this can take all of the available bus time 
and would, therefore, lock out the host CPU from 
processing. For this reason, it is expected that 
only small Portions of the total display will be bit- 
mapped such as in business applications to display 
=a charts or graphs. 


DD 
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To minimize the bus utilization of the. CRTC ‘the 
linked-list describing the graphic should. be 
i ce no windows and-no Seamer ation: 


System Performance 


To improve the system performance .a dual-bus 
architecture . may be implemented. The display 
information is stored in local memory shared by the 
host CPU and the CRTC. Additionally, the CPU 
has system memory to perform the other tasks. In 
this scheme. the host CPU is only slowed down 
when it actually accesses the display data while the. 
CRTC still uses nearly the entire bus bandwidth 
provided by the local memory. 


To calculate the DMA time for a row four iis 
must be considered. The performance data is 
based on the 8-MHz CRTC. 


e Each DMA cycle takes 3 ticks of the CLK1 clock 
_ -assuming operating without Wait states. A bus 
cycle therefore will be 3/8 Mhz or 375 ns. This 
implies, using a transparent address latch, that a 
total of Parameter 4 + Parameter 42 = 30 + 185 = 
215 ns is the maximum access time to sys- 
tem/local memory that will be used for bit- 
mapped data. 


Each row's data consists of: 


¢ Row Control Block (RCB) information (7 words or 
bus cycles) 


e The data to be munca (Two bytes per bus 
cycle) 


e Any attributes that the data invokes (one 
attribute per bus cycle) 


The performance calculations consider three 


different resolutions for the bit-mapped portion of 
the display: 512, 768, and 1024 dots horizontally. 
The former and latter represent low and high end 
applications; the middle resolution is typical for 
many present CRT systems and fits into the hard- 
ware of the CRTC in a particularly convenient way. 


For all of these screen resolutions many common 
considerations will first-be discussed. To simplify 
both the software which generates the bit-map 
data and to optimize the bus utilization, it is 
desirable to place all of the data within, one 
contiguous 64K segment of CPU address space. 
In terms of the CRTC this means that the upper 
address does not need to be updated, eliminating 
Am8052 Bus Master Write cycles and thereby 
saving bus time. For this same reason it is desir- 


\ 


required fill time to zero. 


pie) to have all of the RCB's for the rows of the bit: | 


map in this same address space. 


To minimize the bus request and bus rlaser 


overhead due to handshaking involved it is desir- 
able to have the DMA burst as long as possible. 
The maximum length for a DMA burst is one 
character row. It is programmed when the Burst 
Space value in the Burst Register is set to 004. 


Since character attributes are not, used in graphic 


’ mode it is desirable to turn the attribute fetches off. 


(see Attribute Flag Register). 


A word of explanation is appropriate at this point 
concerning the values to be put into the Row 
Control Block word RAs. The “HIDDEN #’ and the 
‘VISIBLE #” are used by the DMA to ascertain the 
maximum number of characters to be fetched into 
the internal row buffers. For each segment of a 
row, the DMA will fetch a number of. characters 


equivalent to the sum of these two parameters. In . 


graphic mode “HIDDEN #” should be set to zero 


and “VISIBLE #” to 64, 96, or 128 for screen 
resolutions of 512, 768, or 1024, respectively. 
The remaining row buffer entries are filled with the 
programmed fill code. 


Timing Guleulatlons 


The DMA must fetch the control information and 
character data for graphic row in less than the 
horizontal scan time. The number of DMA cycles 
per row can be determined as: 


| R/16+C+B | 
‘number of DMA cycles per row 
screen resolution in pixels 
7 words for Row Control Block 
7 bus cycles for bus exchange and Idle. 
DMA Cycles 


DWODZZ 
iou uw ot oul 


The data (character string) fnuiet be word aligned. 


The CRTC takes additional time internally to fill in 
the row buffer with the default data byte specified 
by the MDB's character fill code. Internally each 
row buffer has 132 entries. However, for screen 
size equal to or less than 96 characters per row, 


- the SLIM bit in Mode Register 1 may be set to | 
reduce the time taken to do the fill operation. This - 


“magic number” was used as the basis for the 
medium resolution selection to reduce the 
The time to fill the 
remaining part of a row it takes_a system clock 
(CLK) cycles Per fill character. 


The Maximum horizontal frequency supported by 
each of the three resolutions is as follows 


(Am8052 at 8 MHz): 
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512 pixels/line 


[512/16 + 14] °3 + (96 —(512/8)) 

[32 + 14] *3 + (96 —64) = 138 +32 
= 170ticksof CLK1=0.021 ms 
Fmax = 47 kHz 


768 pixels/line 


[768/16 +14]*340=[48414]-3 
= 186 ticks of CLK1 =0.023m 
Fmax = 43 kHz 


1024 pixels/line — 
[1024/16 + 14] *3+(132—(1024/8)) 
= [64 +14]-34(132-—128) =234+4 


= 238 ticks of CLK1 =0.029 ms 
Fmax = 34 kHz 


TOP 


IMDB tsic=x 


RCB 
ROB RRBPNTR 
ROB (LNK =0) 


RCB pRB PNTR 


RCB 
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Hardware Implementation 


A latch (Figure 5-11) stores the row attribute data 
the CRTC outputs during horizontal retrace. The 
Am29841 latch is ideal for this purpose as it con- 
tains 10 bits worth of storage in the convenient 24- 
pin slim package and has the correct polarity of 
clock. 


A multiplexer feeds either the 8-bit character code 
(graphic mode) or the character slice data provided 
by the character font generator (text mode) to the 
parallel input of the Video Shift Register. 


Another Multiplexer selects the character width 
from the character font generator (as for propor- 
tionally-spaced characters) or is set to 01108 to 
indicate eight pixels per character clock when in 
graphic mode. 


MAIN DEFINTION BLOCK 
X =8 TO 16 FOR TYPICAL TEXT DATA 


NORMAL TEXT AND ATTRIBUTE POINTERS 
(NO RRB NECESSARY) | 


(LNK = 


0) 


FIRST ROW OF BIT-MAP 


(LNK = 


1) INVOKES RRB 


RRB tS1¢ =0, POWATT =BIT MAP 


LAST ROW OF BIT-MAP 


NEXT ROW OF TEXT 


(LNK = 


1) 


RAB tSLC =X, ROWATT = TEXT 


Figure 5-12 “Linked List” 
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CHAPTER 6 


-Am8052 BUS INTERFACE GUIDE 





6.0 INTRODUCTION 

The Am8052 is a general-purpose. controller for 
raster scan CRT displays. Its link-oriented data 
_ manipulation provides sophisticated text display 
without imposing undue overhead on the host 
CPU. The versatility of this device covers a wide 
range of applications from medium performance up 
to very-high performance displays. 


A wide variety of systems will be able to take 
advantage of its features, turning them into power- 
ful display controllers with a minimum of chip count. 
This application note covers the area in a system 
outlined in Figure 6-1. It should provide designers 
with application hints and information on how to 
interface the device to some of the popular CPUs. 


6.1 PERFORMANCE DECISIONS 


When designing a display subsystem, the system 
designer makes multiple decisions to acheive the 


INTERFACE 







| 
| 8052 BUS: 
| 
| 


MEMORY 


06178A 6-1 


most cost-effective design. The designer finds 
the best compromise between performance and: 
cost; the cost mainly consists of hardware/software 
development and manufacturing. The following 
shows the trade-off between software develop- 
ment cost and hardware cost. 


The basic factors that influence the performance of 
a display system are: 


. Single/dual bus architecture 
. System clock rate 

. Number of wait states 

. DMAburstlength | 

. Full/reduced attribute fetches 


oh aN — 


The hardware designer defines the first three 
factors. The fourth factor is determined by system 
constraints such as real-time response time or multi- 
master bus sharing. The fifth is set by the software : 
designer. The demand attribute fetch feature of 


the Am8052 can be used to reduce bus traffic by 


about 50%. 


CHARACTER 
ONT 


F 
GENERATOR 


Figure 6-1 8052 Bus Interface 
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How is system performance measured? First of all, 
system performance is defined here as the. 


response time of tasks executed by the local 
intelligence. It is assumed, also, that this response 
time is directly proportional to the remaining bus 


‘bandwidth in the CPU. Therefore, parameters 


such as Wait States can be very important in the 
determination of system performance. 


The various factors affecting system séfonbance 
are analyzed in the following. 2 
Single/Dual Bus Architecture 

The single most important decision the system 
designer makes is to implement either a single or 
dual bus architecture. 

In the single bus architecture, (Figure 6-1) the 
CPU, the system memory, and. the peripheral 
devices are interfaced via a single bus, the System 


Bus. With the Am8052, all display information are 
stored in the system memory and the Am8052 self- 


LOCAL BUS 


aint 


SYSTEM BUS 


MEMORY » 
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MEMORY 
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loads this data via the system bus. Consequently, ' 
the more data the Am8052 transfers, the smaller 
the CPU bus bandwidth and lower performance. 
However, this is the simplest approach and re- 
quires no additional hardware. 


The the dual bus architecture (Figure 6-2) is 
implemented in higher performance systems 
where peripheral devices do not claim a share of 
the bus bandwidth. Each peripheral device has ‘its 
local memory and interfaces via its local bus. The 
Am8052 stores all display data in this local memory. 
Thus, the self-load no longer burdens the System 
Bus and Am8052 bus traffic becomes insignificant. 
This set-up does not affect the overall system 
performance. 


When interfacing the Am8052 to synchronous 
buses, performance can be increased if the on-. 
chip (Am8052) bus arbitration logic is not used. 
Instead, an external, synchronous arbitration logic 
is used to arbitrate the System Bus on a cycle-by- 
cycle basis. In this mode, BAI is tied Low to allow 
the Am8052 to perform its transaction at any time. 
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Figure 6-2 Dual-Bus Architecture 
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An active DS (Data Strobe) is treated as an cycle 
request. WAIT is pulled Low for as long as it is 
necessary to hold the Am8052. Upon release of 
WAIT, the agua bus Eyre is performed. 


System Clock Rate 
The Am8052 was originally designed as a Z8000 


peripheral, one that has three clocks per machine 
cycle; this means, performance-wise, a 6MHz 


Am8052 can cope with an 8MHz 8086, or 68000,: 


or one of the MOS microprocessors that operates 
on four clock cycles per machine cycle. It is 
obvious, therefore, that, if the clock rate of the 
Am8052 is high, the Am8052 requires less of the 
System Bus bandwidth and gives a mone! 
performance. 


In order to optimize the system prone with 
the Am8052, the CPU should be operated 
asynchronous to the Am8052. However, since 
some dynamic memory controller operate 
synchronously to the System Clock, the design 
should be simplified to operate both the CPU and 


the Am8052 synchronously. The disadvantage of - 


this approach is that it requires a faster Am8052. 


Wait States | 


A single Wait State increases, by 33%, the bus 
bandwidth used by the: Am8052. The two 
examples in the following show cases in which 
whether or not Wait States are inserted pede an 
important difference. 


In the first example, the Am8052 occupies 6% of 
the bus bandwidth. Inserting a single Wait State 
raises it to 8%, two Wait States raises it to 10%. 
The overall system performance is basically not 
affected. 


Example 1 
Am8052 DMA CPU _ Relative 
Performance 
no Wait ‘ 
State 6% - 94% 1.00 
1 Wait 
State 8% - 92% - 0:98 
2 Wait . 

States 10% - 0.96 


90% 


The difference would be drastically increased if the 
Am8052 occupies a more significant share of the 


bus bandwidth and other DMA devices are also - 


taking their share of it. The following table shows 
the difference in relative performance when DMA 
devices are yinwolved. 


Example 2 
Am8052 DMA CPU Relative 
- 3 Performance 

no Wait 
State 45% 15% 40% 1.00 
1 Wait a, 
State 60% | 15% 25% 0.625 
2 Wait 
States 75% $§15% 10% - 0.250 


Here, the insertion of two Wait States reduces the 
relative system performance to a quarter of the one 
with no Wait State. 


DMA Burst Length 


- The purpose of performing bus transactions in 
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burst is, on one hand, to minimize the effect of bus 
exchange overhead (burst as long as possible) - 
and, on the other hand, to limit the time the 
Am8052 occupies the bus to allow real-time 
responses of the CPU or other peripherals, 


The DMA burst length is another factor which 
affects the system performance. This is due to. bus 
arbitration and bus release overhead. After the 
Am8052 has asserted Bus Request (BRQ Low), 
the system will acknowledge the bus request by 
asserting BAI Low. However, in most systems this 
exchange involves a bus dead time of a few clock 
cycles (overhead). Furthermore, it takes the 
Am8052 about eight clock cycles to perform the 
first bus cycle after receiving bus acknowledge. 


Considering these facts, the bus exchange 
overhead decreases if the burst length is 
increased (less bus exchanges). In the best case 
Burst Space is set to zero. Here, the bus is 
exchanged only once per character row being 
loaded. In the worst case Burst Count is set to “2”. 
Here, single bus cycle DMA bursts are performed. 


which maximize the bus exchange overhead. 


An analysis has shown the overhead iivelved: due 
to bus exchanges | is eee if the burst length 
exceeds 64. 


Full/Reduced Attribute Fetch 


The amount of attribute fetches also directly affect 


the system performance. In lower performance | 


systems the software designer can choose to 
— employ the full attribute fetch mode. This means 
the Am8052 fetches an attribute for each character 
being loaded. The advantage is that this is the 
most simple software scheme which can be 
implemented. There is a fixed relationship be- 
~ tween characters and their attributes. 


' The required bus bandwidth can be reduced by 


about a factor of two when implementing the 
reduced or demand attribute fetch mode. Here, 
attributes are loaded when required. However, this 
scheme involves a more sophisticated software 
since the relationship of characters’ and their 
attributes becomes variable. 


6.2 GENERAL SYSTEM BUS 
APPLICATION HINTS 


The following outlines the unique observations of 
the Am8052 bus interface. 


Upper Address Writes _ 


The Am8052 updates the upper address on a 
demand basis to minimize bus overhead. In upper 
address write cycles (Bus Master Writes), AS and 
R/W are both Low. This is the only time the 
Am8052 pulls the R/W Low. In both segmented 
and linear mode, the upper address (7 or 8-bit, 
respectively) are strobed out on the lower half of 
the address/data bus (ADo_7). Note, that it is not 
possible to OR AS and R/W in order to enable a 


transparent latch (Figure 6-3). Since: R/W ‘pro- 
pagates into the Bus Master Read cycle following — 
the write cycle (timing parameter 10), ORing R/W 
and AS may generate a glitch. Therefore, it is pref- 
erable to take an approach similar to Figure 6-4. 


The upper address is stored ina register-such as _ 
the Am29823. The register is enabled when the 
CRTC is bus master (BAl=Low, and BAO=High). 
and R/W is Low. The register is strobed by the ~ 
trailing edge of AS. The CRTC timing guarantees 
that R/W settles before that nee | 


Slave Tyansters 


The CRTC supports two slave data transfer modes: 


the latched and the unlatched mode. The latched 
mode may be selected for systems with a 
multiplexed address/data bus such as the 8086 
and Z8000. The CRTC latches Chip Select (CS) 
and Control/Data (C/D) with the trailing edge: of 
address strobe. C/D indicates to the CRTC that 
the CPU is going to address one of the internal 


registers (C/D=High), or that the CPU is going to 
transfer data to or from a previously addressed 


register (C/D=Low). With the subsequent data 
Strobe, either the pointer or the data word is 
transferred. The leading edge of data strobe 
latches R/W. The entire cycle may be asynch- 


_ ronous to CLK, or CLKo. 


The unlatched mode may be chosen for systems — 
with demultiplexed address/data bus such as the 
68000. Address strobe being Low enables an 


internal transparent latch to pass CS and C/D. 
through to slave select logic. Therefore, bothCS . 
and C/D must be stable for the entire cycle. AS is _ 

connected to a flag that signals the bus has 
Sapien that is, the address is valid. CS i is the 
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Figure 6-4 Correct Implementation— 
Register Stores Upper Address 


decoded I/O address. C/D usually connects to Ay 
of the system bus. (A; is the least significant 
address in 16-bit microprocessor systems; Apo is 
“don't .care”.) Similar to the latched mode, data 
strobe latches R/W, and transfers either the 
pointer orthe data. 


Clock Input Requirements 


All inputs except the two clock inputs (CLK, 
CLKs) have the normal TTL input voltage/ 
capacitance specification. The two clock inputs 
require a lower Input Low Voltage, a higher Input 
High Voltage; and they have an increased input 
capacitance. The companion part, Am8152A, 
provides clock signals satisfying these require- 
ments. Applications not employing the Am8152A 
can either use CMOS clock drivers or the discrete 
circuit in Figure 6-5. To increase output drive 
capability and improve rise and fall times, CMOS 
drivers can be connected in parallel. 


Interrupt Acknowledge 


The Am8052 provides an interrupt acknowledge 
input to support vectored interrupts. 
operation this input has to be tied high. Note that, 
~ as long as INTACK is Low or floating the device will 
not respond to any slave transactions, or will not 
execute any master transfers. 
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For normal - 


Wait Synchronization 


‘It is very important, that WAIT is synchronized to 


the clock (CLK,), especially when software Wait 
States are enabled. When the number of software 
Wait States is set to zero, and the setup and hold 
times of WAIT to CLK, are violated, the Am8052 
either misses WAIT going High and inserts an 
additional Wait State (not a problem), or it goes 
meta-stable (a seldom case, but a real problem, 
since meta-stable consequences are not predict- 
able). If the WAIT setup and hold timing is violated 
and the number of software Wait States is 1, 2, or 
3, an additional problem occurs. In that case the 
Am8052 does not insert the programmed software 
Wait States, and scans the WAIT input in the subse- 
quent T1 cycle. If WAIT is Low in this T1 state, the © 
Am8052 will hang up this T1 state, characterized 
by AS toggling with the frequency of CLK,. 








Bus Turn-Around 


The bus turnaround times when going from the 
address output (DTEN Low) to data input (DREN 
Low) should be analyzed carefully. Slow driver 








‘turn-off times in conjunction with fast turn-on de- 


lays might cause bus contention on the multiplex- 
ed address/data bus. Therefore, combinatorial 
delays between the transceiver control outputs of 
the Am8052 (DREN, DTEN) and the transceiver 
inputs should be avoided (use transceivers with 


120 


CLK1/CLK2 
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Figure 6-5 CLK1/CLK2 Driver 
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fecaivanianenit control such as Am2949). 
that, in Master Read cycles, the Am8052’ does not 
require a data hold time to DREN or DS, whichever 
goes inactive first. So either DREN or DS may be 
used to enable/disable the data. 








6.3 Am8052 AND AN8-Bit- 
|. MICROPROCESSOR INTERFACE | 


There are two fundamental issues associated with 
mixing devices that. communicate. over different- 
sized buses. The first problem is allowing the two 
devices to communicate on a “common” data bus. 
Consider, for example, a 16-bit system utilizing 8- 
and 16-bit peripherals. Overcoming the mis- 
matched data'paths requires some form of control- 
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16 BIT 






* DEVICE 
16 BIT Fone 
b) DEVICE 
ADDRESS 
c) 


16-BIT 
DATA BUS 


f 


f 


Note 


led multiplexing/demuttiplexing Of ‘the: different 
data paths. In addition, extra control signals: for - 
partitioning. the 16-bit word into 8; and 16-bit: units 
may be required. . Today, most of the 16-bit CPU 
based systems that use. 8-bit peripherals usually 
use just the lower half of the. data bus. to transfer 
data to and from the peripheral. However, this 
scheme does not work when interfacing 16-bit 
peripherals to 8-bit CPUs, especially when these 
peripherals have bus master capability. 


Data Funnelling 


When a 16- bit peripheral attempts i meee aa 
over, an 8-bit bus (memory write cycle or slave read 
cycle), the 16-bit data has to be broken down into 
two bytes and transferred sequentially. First, the | 
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Figure 6-6. Bus Master or Slave Read Operation ae Bae. 
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lower 8-bits are transferred out on the bus (Figure 
6-6a), and then in the next transfer cycle the upper 
8-bits of the 16-bit word are sent out (Figure 6-6b). 
The generalized bus timing for such an operation 
is shown in Figure 6-6c. Figures 6-7a, 6-7b, and 6- 
7c show the opposite case; a bus read operation 
from an 8-bit bus to a 16-bit peripheral. Here, the 
first byte read from the system must be latched. 
Once the second byte has been fetched, the 16- 
bit peripheral reads in the assembled 16-bit (2- 
byte) word. Additionally, provisions may need to 
be made for the case when the 16-bit peripheral 
accesses single bytes. 


Interruptions of the two cycle transfer must be 
analyzed very carefully. Master transfers must not 


the middle of a two-cycle transaction. Similar, slave 
accesses must not be interrupted by master 
transfers. While the interfacing funnels the data, 
the current bus cycle needs to be stretched. 
When the peripheral is bus master, as shown in 
Figures 6-6a, 6-6b, and 6-6c, the 16-bit peripheral 
is holding its data available for what would normally 


‘be two complete bus transfer cycles. This stretch 


can be achieved by delaying the transfer 
acknowledge signal to the peripheral, causing it to 
wait (WAIT asserted). | 


In slave mode, the 8-bit CPU would have to make 
two consecutive réad operations to examine a 16- 
bit peripheral status register. The peripheral must 
not become bus master in between the first and 


be interrupted by slave accesses while being in _ second read operations since this invalidates the 
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Figure 6-7 Bus Master Read or Slave Write Operation 


results of the first read operation. | 
can be handled in two different ways: if the CPU 
has a bus lock instruction (for example, like the 
~ iAPX family of CPUs), then the programmer uses 
one of these before the CPU accesses the 
peripheral. Alternately, the CPU can disable the 
arbitration logic while it is performing the critical 
uninterruptible slave transfer. 


| Developing the Control and Data Transfer 
Interface | 


Designing the control interface to allow mixing 8 
and 16-bit peripherals requires an analysis of the 
data and control flow. The data flow automatically 
defines the data path design (see Figures 6-6 & 6- 
7). The bus master operation by the peripheral is 
relatively straightforward. During a write operation, 
the data is written out sequentially: the lower byte 
first and then the upper byte (or vice-versa). 
During a read operation, the data is fetched 
sequentially. The byte’ fetched first is latched, to 
hold the data until the peripheral can read it. In the 
second byte read cycle, the remaining byte is 
fetched, the 16-bit word is assembled from the two 


This function 


increased, as would the complexity, with no game in 
performance. — be wide , 

The state diagram (Figure 6-8) iilesivenée ‘the 
control sequence implemented in the 8/16-bit bus 
control logic. It also depicts how uninterrupted 
word transfers will occur and how the addresses for 
upper and lower bytes are generated. In addition, 
the specific bus timing of the peripheral and the 
data. bus must be examined to quantify the state 
control flow and provide information on data 
latching, read/write control. strobes, and 
addressing to and from the peripheral. The state 
control flow is broken down into three parts: bus 
master read, slave read, and slave write operations. 


. The three control signals that must be be 


. bytes, and the 16-bit_word is loaded into the - 





peripheral. Similarly, WAIT is asserted until the 
second byte read cycle can be terminated. 


The slave’ mode of operation works almost 
identically to the peripheral bus master mode. The 
master read cycle is similar to the slave write cycle, 
and the master write cycle is similar to the slave 
‘read cycle. In general, if the peripheral puts data 
on the narrower system bus, the peripheral can 
keep the data active in both sequential system bus 
-cycles. On the other hand, if data is loaded into 


__ the peripheral, the interface logic has to latch the 


data of the first fetch cycle, whereas the data of the 
second cycle can be loaded directly into the 
peripheral (no latching required). 


When defining the interface, the designer must. 


-make'a conscious choice about which byte (upper 
or lower) to latch during peripheral read operations 
(or conversely, slave peripheral write operations). 
Once this decision has been made, the CPU must 
-always access the latched data byte first (during a 
slave write) and then access the non-latched byte 
to complete the transfer. This restriction is a minor 
one with no extra software overhead; yet it could 
affect-the ease of the programmer's coding if not 
handled properly. For example, if the programmer 
uses a compiler to generate the software for the 
system, extra care may be necessary to ensure the 
compiler generates the correct addressing 
sequence. An alternative to this solution would be 
to latch both the upper and lower data bytes. In 
that case, the cost of the interface would be 


generated by the 8/16-bit control unit are: Address 
bit_0 (Ap), peripheral hold (WAIT), and bus read 
(RD). The Ap line is generated by the control logic 
to indicate which byte is to be transferred in bus 
master modes only. Otherwise, the Ao generated 
by the system is used to indicate which byte is 
being accessed. The WAIT line holds up the-, 
peripheral during transfers. The RD line is required 
to indicate successive transfer cycles on the bus: 





_ The peripheral's control signals will only strobe 


active once, because the two cycle transfer should 
be kept hidden from the peripheral. 


The slave transfer flows are almest identical, 


except the CPU is generating the bus signals and ; 


the transfer directions are reversed, that is, a bus 
write goes into the peripheral. 


The conceptual logic for the 16-to 8-bit data flow 


example is shown in Figure 6-9. The data on the 


‘upper byte is latched when data is being read (as 


bus master) and read or written (as a bus slave). 
Although this interface must latch data coming 
from the 8-bit data bus into the peripheral, it also. 
needs to act as transceiver when the peripheral is 
sending data out to the system. The ideal part.to 


-accomplish such an interface would be one that 


has a three-stated output, with an 8-bit wide latch, 


in one direction and a three-stated driver in the 


other direction. The Am2952 8-bit bidirectional I/O 


port provides a close match to the targeted logic 


and allows the combining of the upper data bus 
latch and upper data driver chips into one IC. It 
provides two 8-bit clocked I/O ports, each with 
three-state output ‘controls and individual clocks 
and: clock enables. An Am2949 bidirectional bus 
transceiver completes the logic required to buffer 


. the data path. 


The state flow control requires logic capable of 
sequentially moving from state to state, holding in 
a particular State, and pelng reset or initialized back 


; 


toa predefined state. This design integrates the 
state machine generator into the same 


Programmable Array Logic device (PAL) as: the. 


control signal logic. 


The bus control logic required to generate the data- 
path flow logic and the bus control signals is 
considerable. This is especially true if the 
peripherals and CPUs have different signal 
conventions (for example, AS, DS, and R/W 
versus ALE, RD, and WR). Conversion between 
different signal conventions, signal polarity 
changes, and extra functions (such as generating 
Ao) requires quite a bit of logic-synthesis ability. If 
the peripheral has bus master capability, additional 
information, such as bus arbitration controls, must 
be fed into the next state determination logic to 
decide what control sequence to follow. 


Assembling a 8-bit CPU/16-bit peripheral interface 
combines all the individual components discussed 
above. Figure 6-10 shows a typical 8/16-bit control 
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interface. The state machine and the bus and latch 


' controls have to be tightly coupled in order to 


transfer data between the 8-bit and 16-bit buses. 
The generalized machine is designed under the | 
assumption that the peripheral has bus master 
capability. If this is not the case, the design can be 
vastly simplified. 


Since the CRTC does not modify system memory, 
no provision for a bus master write operation 


‘needs to be provided. This provision is important 


because it eliminates the need to generate a 
system write control signal (WR). In addition, the 
control and display information has to be aligned 
on word boundaries. This additional requirement 
relieves the 8/16-bit control logic from worrying 
about funneling the bytes and performing | 
odd/even byte transfers. It also saves control 
inputs from the Am8052 because all transfers are 
words; there is no need for upper and lower data 


. gtrobes or byte high enable inputs/outputs. 


COMMENTS 


WAIT TILL PERIPHERAL TAKES BUS; 
MAKE SURE MEMORY ACKNOWLEDGE IS 
NOT ASSERTED. : 


READ IN UPPER BYTE; hgats 
WAIT FOR MEMORY ACKNOWLEDGE; 
ISSUE RD STROBE. ; 


WAIT FOR MEMORY ACKNOWLEDGE 
TO GO AWAY. 


READ IN THE LOWER BYTE; A,=0; 
WAIT FOR MEMORY ACKNOWLEDGE; 
ISSUE RD STROBE, 


STROBE IN DATA TO PERIPHERAL; 
DEASSERT WAIT: 
WAIT FOR SUCCESSFUL READ. 


Figure 6-8 Bus Master Read State Flow Control 
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Figure 6-10 Data Funnel Logic 
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The slave accesses by the CPU are either pointer 
writes (to select the desired control/status register) 
or 16-bit data read/write operations. The pointer 
write operation is really an 8-bit operation because 
only the lower 8 bits of the data form the register 


address. This is illustrated in the flow diagram by . 
the path that bypasses half the slave read/write - 


states if the command/data (C/D) line is High. 
These state flow diagrams are derived directly from 
the timing diagrams of the Am8052. The three 
different transfer timings are shown in Figures 6- 
11, 6-12, and 6-13. 


Two special conditions have been incorporated 
into the state flow diagrams whenever a transfer is 
first initiated. Before a new transfer cycle is at- 
tempted (that is, the state machine is waiting in 


DSgos2 


UPPER BYTE 
TRANSFER 


LOWER BYTE 
TRANSFER 


AANA 


MEMACK 


TT 


SO), the memory acknowledge must be inactive. 
This prevents any interference from the last 
transfer. The second special condition occurs 
when the Am8052 asserts the R/W line to indicate 
a write operation. Whenever the Am8052 updates 
the upper 8 bits of the 24-bit address latch, the 
R/W line indicates a write operation (in conjunction’ 
with AS). The Am8052 is not actually performing a 
system data write, only an address latch update. 
Hence, the state flow reflects this fact by not 
starting a sequence if the R/W line is active Low . 
fromthe Am8052. 


These simplifications allow the Am8052 to 8-bit 
CPU control interface to be synthesized in a single 
AmPAL22V10 device (Figure 6-14). In addition, 
the bus contro) signals are converted from AS, DS, 


WXYZ) WQXXQQa as’ 
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WAIT : | . 
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Figure 6-11 Bus Master Read Timing Diagram 


6-11. 





SYSTEM 


Figure 6-12 Slave Read Timing Diagram 
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Figure 6-13 Slave Write Timing Diagram 


6-12 


06178A 6-15 


¢ 


os 


06178A 6-16 


and R/W to RD and WR. Figure 6-14 shows the 
assembled control and data transfer logic for this 
interface. The minimum Am8052 and _bus control 
signals that have to be generated are RD, Apo, DS, 


R/W. Although DS and R/W are used as inputs ~ 


during a bus master operation by the Am8052, the 
AmPAL22V10 must convert the CPU RD and WR 
signals to DS and R/W_for slave I/O operations. 
The signals Ag and RD are generated by the 
control logic when the Am8052 is performing a 
read access to the system. The WAIT (or not 
READY) signal to the Am8052 also needs to be 
generated by the control logic. Additionally, the 
four control signals of the bidirectional port and 
transceiver are generated. 
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’ display 


Trade-offs and Limitations 


In a design dramatically affecting the I/O of the 
system, a number of trade-offs and limitations 
should be noted. The most obvious limitation in 
using 16-bit peripherals on an 8-bit bus is that the 
16-bit peripheral will be under-utilized. The speed 
of all I/O operations will be cut by 50%. 
Consequently, the bus utilization will go up if the 
16-bit peripheral represents a significant factor of 
the bus usage. A CRT controller like the Am8052 
might use 5% to 10% of the bus bandwidth for 
information when using 16-bit 1/O. 
Converting to 8-bit I/O would double bus usage to 

10% to 20%, or more.. 
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Figure 6-14 Am8052 8-Bit Interface 


_ Another factor that might affect the bus usage is 
the efficiency of the 8- to 16-bit conversion control 
logic. If the state machine designed to perform the 


8/16-bit conversion (or 16/32-bit) is improperly — 


designed, then extra transfer overhead may be, 
introduced. This could mean a sequential transfer 
of two 8-bit values takes longer than two single 16- 
bit transfers. The system designer must weigh the 
cost of thé extra overhead on’a case-by-case 
basis. However, as previously mentioned, the 
benefits may well justify these limitations; the bus 
is self-limiting, but the device characteristics allow 
for value-added designs. 
degradation for certain. configurations, extra logic 
and design effort are involved. However, most 
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In addition to bus’ 
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Figure 6-15 8086-Am8052 Interface 


interfaces outside a system's immediate family 
require some kind of extra. interface logic anyway. 


Therefore, by optimizing the control signals.and | 
_ incorporating 
devices such as the AmPAL22V10, the IC count 


them into programmable logic © 


canbe dramatically reduced. 


6. 4 THE Amsa052 AND 8086 INTERFACE 


IN MIN MODE ~ 


The 16-bit multiplexed address/data bus of the 
8086 is directly connected to the multiplexed — 
address/data lines of the Am8052, Figure 6-15. 
The.upper address (7 bit for segmented mode or 8 


f 


DS R/W 


Am29809 fo 


Am8052 
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bit for linear mode) is strobed out on the lower half 
of the bus (ADop_g or ADo_7) and is stored in a 
register (Am29823). The Am8052 may be pro- 
grammed for segmented or linear mode depend- 
ing on whether address roll-over is desired. The 


register output is enabled (OE=Low) when the © 


Am8052 is bus master. . Clocking is enabled 
(EN=Low) when R/W is Low while the Am8052 is 
bus master (upper address update cycle). The 
trailing edge of Address Strobe clocks the register. 


RD and WR from the 8086 are logically ORed to 
generate DS. ALE is inverted and connected to 
AS of the Am8052. DT/R is also inverted to form 
R/W. All three signals are passed through a three- 
state buffer which is enabled when the 8086 is bus 
master. Memory/lO (M/IO) is pulled High when the 
Am8052 is bus master since the Am8052 only 
addresses memory. 


Bus Clock 


The Bus Master timing is synchronized to the bus 
clock (CLK) of the Am8052. In order to get a 
similar and synchronous bus timing when the 8086 
or the Am8052 are driving the bus, the Am8052 
bus clock can be connected to the 8086 bus 
clock. However, in proportional spacing appli- 
cations, the video timing must be derived from the 
bus clock and therefore the bus clock must be 
synchronized to the character clock (CLK9). 


For these applications the Am8152A provides the 
synchronized clocks (CLK1,CLK2) with the- right 
timing and DC specification. 


In non-proportional spacing applications, the 
Am8052 can operate with the 8086 bus clock if the 
duty cycle is adjusted. In this case, the Am8152A 


cannot be used as the clock driver, and a separate | 


clock driver needs to be provided. This clock 
driver must provide a clock satisfying the special 
clock input specification (MOS specification) such 
as clock High and Low width and voltage, and input 
capacitance. Most CMOS drivers or a discrete 
clock driver shown in Figure 6-5 satisfies these 


specifications. This design must be changed for 
different frequencies. Figure 6-16 shows circuitry 
which adjusts the duty cycle for the Am8052. The 
required delay time needs to be adjusted for the 


_ chosen bus clock frequency. 


At high bus clock frequencies (e.g., 2 8 MHz) Bus 
Request of the Am8052 must be synchronized to 
the clock, to penetel a synchronized HOLD for 
the 8086. 


Detailed Timing Analysis 


The following timing analysis is based on an 8-MHz 
8086-2 and an 8-MHz Am8052. At this frequency 
the minimum clock High (TCHCL) and Low | 
(TCLCH) times for the 8086-2 become 43 ns and 
68 ns, respectively. Some of the subsequent 
calculations are based on these values for TCHCL 
and TCLCH. 


Slave Reads and Writes 


#21 CS set-up time to the trailing edge of AS 

(minimum 0 ns). The 8086-2 provides a set- 

up time of 28 ns of ADop_45 before the trail- 

ing edge of ALE. Let us assume 0 ns of min- 

imum propagation delay since neither the 

inverter nor the driver specifies one. The 

maximum propagation delay allowed for the 

decoder is, therefore, 28 ns (68 ns—40 ns). 

The decode time for the Am29806/809 
decoders is 13 ns. 


#22 — CS hold time after the sai edge of AS 
_ (minimum 25 ns). The 8086-2 provides a 
minimum address hold time of 33 ns. 


#23 C/D set- -up time before the trailing edge of 
AS (minimum 0 ns). The 8086-2 provides 
an address set-up time of 28 ns. 


#24 .C/D hold time after the trailing edge of AS 
(minimum 25 ns). The 8086-2 provides a 
minimum address hold time of 33 ns. 


#25 Delay from CS to DS (minimum 30 ns). The 


DELAY-LINE 
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Figure 6-16 Duty Cycle Adjustment for the Am8052 


i 2 B45 


worst case noice ae L can be. ak 
culated: as: 


| (TCLCH- -TCHLL) + TCLRL: 
+(28ns—13ns) | : 
= (68 ns—55 ns) +10 ns + (281 ns—13 ns) — 
=37ns. 


#26 Access time (maximum 150 ns). The 8086- 
2 expects an ule access. time no longer 
than: 


2° TCLCL—TCLRL-—TDVCL 
=2°125ns—100ns—20ns 
= 130 ns. 


This means that one Wait State must be inserted. 


#27 Data hold time (minimum 10 ns). The 8086- 
2 requires a max. data hold time of 0 ns, i.e., 
no hold time. 


#28+ R/Wto DS. Since DT/R is connected to the 
29 R/W input of the CRTC, this ming is not 
| guaranteed by design. 


#32 Data hold time during slave writes (minimum 
20 ns). The 8086-2 provides at least 38 ns. 


#33 Data set-up time in slave writes (minimum 90 
ns). The 8086-2 provides more than one 
Clock period (125 ns) data set-up time. 


#34 The Am8052 requires a minimum Data 
_ Strobe pulse width of 100 ns. The 8086-2 
provides 3 


TWLWH 
=2°eTCLCL—40ns 
=210Ns. 


#35 Recovery time (minimum 330 ns). The 
8086-2 provides more than 3.clock periods 
=37/5ns. 


6.5 Am8052 AND 68000 INTERFACE 


One of the designer's most challenging tasks is to 
interface two generically different Bus Masters. 
Such as the 68000 microprocessor and the 
Am8052 CRT Controller. Both Bus Masters sup- 
port a 16-bit-wide data bus and a 24-bit linear ad- 
' dressing space (if the Linear/Segmented bit in the 
‘ Am8052 Mode Register 1 is set to “1”). The con- 


trol bus signals. of the Am8052, however, differ | 


from that of the 68000's and need to be translated 


bidirectionally. Figure 6-17 shows the interface » 


schematics. 


Slave Mode 


The Am8052 provides two basic ve modes: the 


latched mode for systems with multiplexed 
address/data buses and the unlatched mode for 
systems with demultiplexed address/data. buses. 
In this interface application, the Am8052 operates 
in the unlatched mode because the address and 
data buses of the 68000 are demultiplexed. In this 
mode, Address Strobe (AS) is kept asserted 


throughout the entire bus cycle, making the inter- . 
nal latches for Chip Select (CS) and Control/Data__- 
 (C/D) transparent. 


AS is driven Low by an. open 
collector inverter connected to BAI. This forces 
AS to go Low whenever the Am8052 is not. in 
control of the bus. 


Slave Access Timing Analysis: 


The Am8052 timing parameters are analyzed in 
ascending nu merical order. 


#25 The set-up time of Chip Select (CS) to Data 
Strobe (DS) must be at least 30 ns in order 
to: guarantee the minimum access time 
(#26). Violation of this specification could 
happen if Parameter 26 is lengthened, as 
shown below. | 


#26 When CS and DS are asserted simultan- 
eously, the access time increases from 150 
ns (#26) to 180 ns (150 ns + 30 ns). The 
68000 requires an access time of 175 ns 
(2.5 » 125 ns — 60 ns — 15 ns) to operate 
without Wait States. No such Wait States 
are necessary for slave reads. 


#27 The data hold time requirement of 0 ns 


(68000 read operation) -is easily met; the 
Am8052 provides a minimum of 10 ns. 


#28 The R/W setup time requirement of 0 ns 
before DS (Am8052) is is aeer by the 
- 68000 (1 clock cycle). = 


#32 The data hold time (20 ns) in slave write is 
provided by the 10-MHz or slower 68000s. 


#33 The data set-up time before the trailing 
edge of data strobe (80 ns) is on by 
the 8-MHz 68000 (145 ns min). 


#34 The minimum guaranteed write pulse width 


of the 8-MHz 68000 is 115ns. The Am8052 
requires at least a 100 ns pulse. Similar to 
#26, smaller values for #25 cause the DS 
pulse width (#34) to be widened. In order to 
satisfy this parameter, either the set-up time 
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#24 must be at least 15 ns or one Wait State 
(68000) must be inserted. The 15 ns set- 
up time demands a fast chip select decoder. 


#36 The CS to DS hold time (5 ns) is satisfied by 
the address hold time of the 68000 (30 ns 
min). m 


#37 Sameas #36. 


{ 


Data Strobe 


The Am8052 in slave mode can only be accessed 
as a 16-bit peripheral (word transfers only). This 
means that both Data Strobes of the 68000 (LDS 
and UDS) must be active simultaneously. {t is only 
then that the OR gate asserts DS for the Am8052. 


_ The driver is enabled when the 68000 is Bus 


Master (BAI High). In Master Mode, both data 
strobes are driven by the Am8052 because it does 
only word transfers. 
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Master Mode 


After the Am8052 jis initialized and the display is 
enabled, the Am8052 asserts Bus Request 
(BREQ Low) to request the system bus. The bus 
arbitration scheme between the Am8052 and the 
68000 is discussed in the paragraph below. To 
avoid bus contention at the end of. Bus Master 
read cycle, the data bus transceiver (not shown) 
must be turned .off before the Am8052 starts 





driving the address for the next cycle.. Timing — 


Parameter 11 allows a turn-off time of 25 ns which 
is sufficient for the Am29863 transceiver. 


Bus Arbitration 


The 68000 CPU supports a three-wire bus 
arbitration mechanism. A peripheral requesting 
bus mastership asserts a Bus Request (BR Low), 
see Figure 6-18. The CPU, in response, asserts a 
Bus Grant (BG Low). At the end of the current bus 
cycle, the requesting peripheral goes on the bus. 


The end of the current CPU bus cycle is signaled | 


by the Address Strobe going inactive. The 
combination of Bus Grant active and Address 


Strobe inactive asynchronously resets FF2 (see . 


Figure 6-17), thereby asserting BAI for the 
Am8052 and Bus Grant Acknowledge (BGACK). 
Resetting FF2 also resets FF1 asynchronously, 
which deactivates BR. In- response to BR 


becoming inactive, the 68000 deactivates BG. 


BRQgo52 


BResooo 


BGACK, BAI 


Note that BR must be Low for at least 20 ns after 
BGACK to prevent rearbitration. The inverters and 
the delay’ through FF1 must meet_ this 
requirement. BGACK and BAI stay asserted until 
the Am8052 terminates its DMA burst and releases 
BREQ. At that time FF2 is asynchronously set and 
BGACK and BAI are deactivated, and the 68000 
resumes operation. 














The bus arbitration mechanism does not yet 
support DMA preemption. However, Am8052 
DMA preemption by external devices can simply 
be supported by setting FF2 on preemption. The 
preemption DMA can grant the bus after the 
Am8052 has released the bus by deactivating 
BREQ. In this case, BAI being Low is no longer 
sufficient to flag that the Am8052 has been 
granted the system bus. For proper DMA 
preemption support, the data strobe drivers and 
the open collector driver for AS must be controlled 
by a signal.which flags that the Am8052 is on the ~ 
bus. (Note: For the time between preemption (BAI 
High) and bus release (BREQ High), the Am8052 
is still in control of the system bus). 








Interrupt Acknowledge 


_ The Am8052 supports vectored interrupts if the 


No Vector bit in Mode Register 2 is disabled 
(NV=0). The vector is put out in Interrupt Acknow- 
ledge cycles (INTACK Low, IEI High, and DS Low). 





BGgs000 \ / 
— rere “\ Of 
ASéso00 








ASgos2 : 2 / 


PROCESSOR —e| «———— Am8052 | PROCESSOR 


Figure 6-18 Bus Exchange Timing 
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6.6 Am8052 AND 80188 INTERFACE 
WITH DUAL BUS ARCHITECTURE 


With today's predominantly 16-bit systems, some 


new designs still evolve around the 8-bit structure. | 


The underlying reason is cost. Systems designed 
for specific control operations can usually be satis- 
fied with state-of-the-art 8-bit CPUs such as the 
80188. They do not require the slightly higher per- 
formance 16-bit CPUs such as the 80186. The 8- 
bit system design requires less memory devices 


(EPROMs, RAMs) and less MSI-devices (address . 


latches, data bus drivers). 
as well. 


‘Board layout is simpler 


eae te 
With all the attractiveness of an 8-bit system 
design, interfacing such a system with the 
Am8052 must maintain the low cost level. The 
additional cost of designing an 8-bit system 
interfacing with a 16-bit device must be kept as low 
as possible. 


The interface design outlined below contains only 
low cost, 
AmPAL16L8, byté-wide registers, drivers and 
transceivers (Am2947, Am2956, and Am2959) 
and afew standard TTL devices. 


Data Path (Figure 6-19) 


The previous section analyzed the strategy and 
general problems associated with designing the 
-Am8052 into an 8-bit system. There the Am8052 
interfaces with the byte-wide memory and micro- 
processor via a 16-bit to 8-bit data funneling logic. 
The drawback of that design is a significant system 
performance degradation due to the Am8052 
DMA activity. | 


The design discussed here avoids this drawback 
_by implementing a dual bus architecture. The 
Am8052' fetches the display information from a 


local memory, without affecting the operation of — 


the microprocessor. This local memory is 
implemented in two static memory devices (e.g. 8K 
¢ 8 static CMOS RAMs). The bus arbitration logic 
controls CPU accesses to the local bus, pre- 
empting the Am8052 whenever necessary. 
Depending on whether the Am8052 is bus master 
or bus slave, the bus arbitration logic has to take 
actions listed in the following, in order to grant the 
local bus to the CPU. 


If the Am8052 is in slave mode, the arbitration logic 
prevents the Am8052:from granting the local bus 


by blocking Bus Acknowledge (BAI stays High). 


The CPU then accesses the local memory without 
asserting any Wait States. Since the Am8052 


off-the-shelf devices such as the - 


typically uses about 5 to 20% of the bus bandwidth 
(80 to 95% of the time the Am8052 is off the bus), 
this can be considered to be the normal case. 


If the Am8052 is bus master, the CPU transfer 
cycle is stopped temporarily by inserting Wait 
States (ARDY Low). To minimize the wait time, the 
Am8052 DMA is immediately preempted (BAI 
High). As soon as the Am8052 releases the bus 
(BRQ High) the CPU transfer cycle is terminated 


~ (ARDY High). 


Control Logic 


The control logic consists of three separate units: 
The “Master” unit (Detail A in Figure 6-20), the 
“Bus Arbiter” (Detail B in Figure 6-20) and the PAL 
device (Figure 6-22), converting the CPU-Am8052 
signals and generating the various control signals 
for the data path logic (Figure 6-19). 


The “Master” Unit | 


The “Master” unit generates a signal MASTER, 
which indicates if the Am8052 has granted bus 
mastership on the local bus (MASTER Low). 
MASTER. is the output of a flip-flop built out of 
OR/AND gates. Master is asserted when the 
Am8052 receives a bus acknowledge » (BAI Low), 
after it has requested the bus (BRQ Low). 
MASTER then Stays active until the Am8052 
releases the bus (BRQ High). In applications not 
involving DMA preemption, MASTER _can be 
generated simply by OR’ing BRQ and BAI. This 
simplified logic does not generate a correct 
MASTER signal in case of DMA preemption, 
because the Am8052 is bus master while BRQ is 
Low and BAI is High (time between preemption 
and bus release). | 


The “Bus Arbiter” 


This simple logic arbitrates between the CPU and 
the Am8052 where the CPU has higher priority. 
When the Am8052 is in slave mode and.the CPU 
accesses the local-bus (MCS Low or-PCS Low), 
ARDY becomes High and BAI is blocked from 
going Low, in order to prevent granting the Bus to 
the Am8052. When the Am8052 is bus master 
and the CPU accesses the local bus, ARDY is 
asserted and DMA preemption is initiated. This 
forces the Am8052 off the bus. To avoid glitches 
on BAI, and satisfy the minimum. width requirement. 
for BAI, DMA preemption is delayed until the next 
address strobe (AS Low). 
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Figure 6-20 Bus Aibitration Logic 
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Figure 6-22 Control Logic 
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Slave Access Sequence 


The CPU loads internal registers of the Am8052 in 
two cycles. First, .it strobes the upper data byte 


into a latch by asserting PCS». Next, both data 


bytes are loaded into the. Am8052 ‘by asserting 
PCS}. a | 


To minimize interface logic, this application does 


not support read accesses of the upper byte of the . 


internal registers. Only the lower byte can be read. 
Contents of control registers can be tracked by 


iar) 


‘software in memory, therefore it is not necessary to 


be able to read these registers. All status bits 
except the “Scroll In Progress” (SIP) bit are located 
in the lower byte and can be read. However, the 
SIP-bit can be scanned while using vectored 


interrupts, because it is included in the ‘interrupt 


vector. a, 


When the Am8052 is in slave mode, the least 


significant CPU address line (Ap) selects the - 
memory device for the upper (Ag Low) or lower 


_ byte (Ag High) and the appropriate transceivers. 


PAL Design Specification 


AMPAL16L8 
PATOO7 So) 
Interface 80188 -— Am8052 


PAL DESIGN SPECIFICATION 
H.-J. Ruehl 1/15/85 


Advanced Micro Devices, Stuttgart, West Germany 


/PCS1 


/MCS AO. /DEN ALE /RD /WR  DTR/ MASTER GND 
RW /DSH /DSL /AS /DS /WE /OE2 /OE3 /OB4 vcc 
DSH = MCS*DS*AO*/MASTER + DS*/WE*MASTER 
DSL = MCS*DS*/A0* /MASTER -+ DS*/WE*MASTER 
IF (/MASTER) THEN AS = ALE 
IF (/MASTER) THEN DS = RD + WR 
IF (/MASTER) THEN WE = DTR 
OE3 = /MASTER*PCS1*DTR 
-OE4 = MCS*DEN*A0*/MASTER 
| OE2 = . 


\ 


MCS*DEN*/A0*/MASTER + /MASTER*PCS1*DEN 
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CHAPTER 7 
LOW-COST SMART TERMINAL DEMO SYSTEM 


aes) 


7.1. INTRODUCTION 

This project was initiated to demonstrate that a low- 
~ cost, but high performance terminal can be built 
based on the Am8052/Am8152A CRT controller 
chip'set. It shows that it is possible to design a high- 
performance display system with limited amount of 
memory (just 16 kBytes) and a low-cost CPU (the 
Am8051) (Figures 7.1, 7.2, and 7.3). The arch- 
itecture of the Am8052 allows display updates and 
editing tasks to be performed with a minimum load 
on the local CPU (mostly pointer changes rather 
than block moves). However, by providing more 
memory or a faster CPU, the overall system 
performance can be further improved. 


Note. The hardware design ‘and the corre- 
sponding software package are the property of 
Advanced Micro Devices Inc., Sunnyvale: Howev- 
er, since this project is intended to be a promotion 
tool for the Am8052, the complete (or any part of 
the) hardware or software may be copied and used 
in other designs. Soucre code and listing files are 
made available on IBM PC compatible floppy-disks. 


The complete demo set consists of: 


Hardware description (Section 7.4) 

Software users manual (Section 7.5) 
Comparison to other terminals (Section 7.6) 
Source files (2 floppy-disks) 

Listing files (2 floppy-disks) 

Demo program (1 floppy-disk) 

Am8052 Terminal Board (IBM PC form factor) 
Cable for async communication port 
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The following items are required, but not provided: 
e Power supply: IBM PC or ext. power supply 
e IBM PC monochrome monitor plus AC power 


- cable 
e IBM PC/XT/AT with async port (COM 1) 


7.2. DEMO SET-UP 
Take the following Steps to set up the demo: 


e Turn off the power to the IBM PC/XT/AT or 
"compatable . 
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e » Open chassis by removing five screws located 
onthe back side of the eystem 


Insert the Am8052 Teanilaal board into one of 
the empty slots 


Connect the bottom 9-pin D-Connector (J4) to 
the async port of the PC (COM1). The cable is 
supplied. 


Connect the upper 9-pin D-Connector (J3) to 
the monochrome monitor. The cable is attached 
to the monitor. 


Geta the monitor to AC power. A special 
cable is required, but not supplied. A spare IBM 
PC eee cable can be used. 


Turn on the PC power. After a few seconds a 
cursor should show up at the top left corner of 
the display. Also, the PC should boot up. If 
either item does not happen ,turn off power and 
re-check the connections. 


Insert demo disk into the PC and execute demo 
by typing the following command sequence: 


BASICA (to load basic interpreter) 
‘ LOAD “DEMO” _ (to load source of demo) 
RUN (to execute demo) 


If the demo disk contains the compiled (faster) 
version of the demo called “D EMO. EXE”, it may 
be executed by typing: 


DEMO (to load and execute 


demo) 


Various parts of the demo may be executed by 
selecting items of the main demo menu. 


Speed 


The terminal board operates at 9600 baud. The 
baud rate may be changed by reprogramming 
EPROM addresses SFFOH and S3FF1H. -For 
example, to set the baud rate to 19200 the value at 
3FFOH (DbIBaudOpt) should be set to 80H, and 
the value at 3FF1H (BaudRatCnt) to FDH. 


} 


The demo program written in BASIC supplies 
characters at a lower rate than equivalent to 9600 
baud. To show higher screen update rates, the. fol- 
lowing command may be executed: 


COPY A‘DEMO.BAS COM1: 
_ This command copies the source-file of the demo 
program to the terminal board. The font loading per- 
formance may be shown by down-loading the file 
““B8052FONT.DOC” to the terminal board. It will 
define the 120-character-per-line font. 

COPY A:8052FONT.DOC COM1: 


The Am8052 can currently load.one new character 


the relocatable program segment set to 0040H. 


The absolute file produced by the linker can than 
be uploaded to a PROM programmer. The baud 


- rate is defined in the C_CONFIG module. the 


font matrix (7*12 pixel) per frame (about 60 


chars/sec). Defining the characters using the ANSI 
standard it takes about 50 bytes to describe a 
single character. At 9600, baud about 1000 
bytes/sec.can be down loaded. This results in an 
update rate of 20 characters/sec which is limited by 
the data rate of the async line. 


The terminal has been speed optimized. The 
character placement and CR/LF routine have been 
speeded up as much as possible. The result is, 
that this board can‘operate at 19200 baud without 
interface handshake (no control signal, no 
XON/XOFF) as long as no escape sequences are 
sent to the terminal board. 


7.3 BUILDING PROCEDURE 

There are nine assembly source files supplied on 
two IBM PC compatible disks. The files are listed 
below: 


“Interrupt Handlers 


C_BASE 

"GC INIT Initialization 
C_ SWITCH Dispatch Control : 
C_TABLES Control Tables (easy are lneseres 
C_WORK Control Routines 
C.NTiL System Utilities 
C FONT © 80 Character-Per-Line Font 
C_CONFIG Configuration 
C MemMap 


Included Definitions 


Each of these files is down loaded to. the HP 
64110A Logic Developement System. The first 
eight files are assembled with the Am8051 Cross 
Assembler. The resulting object files must then be 
linked together. Both C_BASE and. C_CONFIG 
contain absolute addresses. C_BASE also 
contains relocatable program memory as do the 
remaining six modules. All eight modules should 
be specified together in the link with the base of 


locations “DblBaudOpt” and “BaudRatCnt” corre- 
spond to the special function registers PCON and 
TH1, respectively. The Am8051 timer 1 is used to 
generate the serial communications clock descri- 
bed in the 8051's users manual. Only the most 
significant bit of “DblBaudOpt” (corresponds to 
SMOD) is relevant. 


Keyboard Interface 


The keyboard logic is copied from the IBM PC/XT 
Technical Manual. It is provided as an example 
only. The hardware is not tested. In fact, if U15 is 
installed the system will not operate. The current 
software does not support the keyboard interface. 


7.4. HARDWARE DESCRIPTION 


While the the cost for VLSI is decreasing, the so 
called “dumb” terminals take over more and more 
features of their smart companions. Performance, 
features, and ergonomics are the important consid- 
erations for todays generation of low cost term- 
inals. Large eye-saving, operator friendly non-glare 
screens, which can be tilted or swiveled to suit the 
user, combined with high resolution smooth 
scrolling displays highlight the ergonomic features. 
Functional enhancements include user program- 
mble function keys, programmble screen formats 
(80 or 132 columns), a stationary 25th status line 
with the time of day. High screen update rates, and 
text editing speed are characteristic of these high | 


performance terminals. 


First generation alphanumeric CRT controllers 
such as the 6845 (Motorola) or the 8275 (Intel) 
became the standard for low cost systems. 
However, as the demand for enhanced features 
increases, these very low cost controllers lose their 
attractiveness. Implementing additional features 
with external logic would raise the cost. Second © 
generation controllers such as the Am8052 are 
becoming more cost effective since these control- - 
lers integrate enhanced functions in a single 
device. Furthermore, drastic price reductions 
made possible by die shrinks and cost saving pack- 
aging techniques (i.e. PLCC—Plastic Leaded Chip 
Carrier) now match the requirements of this very 


- cost Sensitive market. 
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An. Am8051/8751 micro- seratsliar is chosen as 


the local intelligence. It receives display commands 
from the host system via an asynchronous 
communication channel and _ interprets them, 
eventually generating the display list for the 
Am8052. Both the CRT controller and the micro- 
controller share a 16kbyte static RAM array which 
stores this display data. The Am8051 controller 
views this memory as 16kbytes (8-bit interface) 
while the Am8052 views it as 8k words (16-bit 
interface). Four standard latches (74LS373) and a 
PAL device demultiplex the address buses and 
implement the data funneling logic to interface the 
8-bit and 16-bit bus masters. 


Since the Am8052 off-loads display and editing 
tasks from the processor, little CPU activity is 
required. With the Am8052, editing tasks such as 
swapping pages, inserting/deleting lines or charac- 
ters are implemented via pointer manipulation 


rather than data block moves. The simple, inexpen- 
sive Am8051/8751 micro-controller is, therefore, 


capable of executing all display fast and efficiently. 
The distinctive characteristics are listed below: 
e two display formats (selected by software) - 
-80 + 24 characters with 9 * 14 pixels/char-cell 
' 420 +30 characters with 6 « 10 pixels/char cell 


e optionally up to three trailing blanks may be 
appended to simplify text right justification 


e windowing and vertical smooth scrolling 
e proportional spacing 


e highlight, superscript, subscript, reverse, under- 
line, overscore, blinking, multiple cursors 


Additional features requiring extra hardware: 


e soft loadable character font generator 
(single port RAM) 


@ horizontal smooth scroll 
e italic characters generated by hardware 


e Kanji/Chinese character set 


System Interface 
Addressing | 
Two transparent address latches (74LS373) de- 


multiplex the 16-bit address/data bus of the 
Am8052 and, in addition, the 8-bit address/data 


bus on Port 0. Both latches are_énabled if either 
ALE of the Am8051 (gated with BAI) or AS of the 
CRTC are active. The output of the lower latch is 
always enabled, the output of the upper latch is 
only enabled if the CRTC is bus master (BAI Low). 
Otherwise, the upper address is directly driven by 
the Am8051. Port 2 (upper address byte of the 
Am8051) cannot be connected to the inputs of 
the upper address latch, because this would result 
in bus contention, when the Am8051 reads the 
upper RAM. | 


Am8051 Address Map 


The Am8051 addresses data memory (IC3 and 
IC4), the internal registers of the Am8052, and the 
keyboard logic. These cycles are flagged by BAI 
being inactive, and by either RD or WR being 
active. The PAL device perform the decoding task. 
The address map is listed below: 

0000H-3FFFY keyboard logic (odd addresses 
only!) 

Am8052 internal registers 
data memory (IC3 and IC4) 
reserved . 


40004-7FFFy 
80004-BFFFy 
CO004y-FFFF} 


Note, that reading even addresses activates the 
output of IC1. The keyboard logic must,.therefore, 
be accessed by odd addresses only. The I/O ad- 
dress space is defined as follows: 


keyboard latch (IC21) (read only) 


0001, 
4000} Am8052 register data access 
3 (high byte, R/W) 
4001, -Am8052 register data access 
(low byte, R/W) 
4003} Am8052 register pointer 


(low byte, write only) 


The proper sequence of accessing both halves of 


_ the Am8052 registers is crucial. Before performing 


any register access the pointer must be loaded. 
When writing a register first the high byte is latched 
(even address), then the low byte (odd address) is 
provided. In the second cycle, the interface 


a _ controller supplies both bytes to the Am8052. 


When reading a register the two cycles are per- 
formed in the reverse order. First, the low byte is 
read (odd address), then the high byte (even 
address) is read. | 


Bus paren 


The “AmB051 performs the bus arbitration i in 


software. The bus request of the Am8052’ (BRQ) 


interrupts the Am8051. In the following interrupt 
service routine the Am8051 three-states Port 2 


(upper address bus) and Port 0 (lower address/ 
data bus). Then it acknowledges bus request by 
granting the bus to the Am8052 by pulling P1.2 
Low (BAI Low) and P1.3 High (AS High). P1.2 
controls the bus acknowledge input (BAI) directly. 


P1.3 pulls the address strobe line of the Am8052. 


(AS) Low whenever a slave access is planned. For 
Am8051 memory accesses P1.3 must be High to 
allow ALE to propagate to the address latch (AST 
Low). A High on any port 3 pins is equivalent.to a 
floating output since each of these pins has an 
open-drain driver with internal pull-up resistors. 


The Am8051 scans the level on the interrupt input 
frequently to determine when the CRTC releases 
the bus. In response, the Am8051 removes Bus 
Acknowledge (P1.2 High and P1.3 High). This 
design can support DMA preemption, since the 
Am8051 can preempt the Am8052 whenever ap- 
propriate by removing BAI. The Am8051 program 
loop executed while the Am8052 controls the bus, 
must be located within program memory internal to 
_ the Am8051. 


Am8051 Memory Access 


The 8-bit Am8051 accesses the 16-bit RAM in 
byte mode. For even addresses (Ag Low) IC16 is 
selected, for odd addresses (Ag High) IC24 is 
selected. IC14 latches the lower address byte: 


Port 2 provides the upper address byte directly. . 


IC5 and IC13 are both disabled, since data will go 
directly to Port.0. The lower RAM (IC 16) is selected 
(CS4 Low); IC24 is disabled. In read cycles the 


Register Write 


The Am8052 registers are accessed in two cycles. 
The first write cycle latches a pointer to the register — 
to be accessed (C/D High). In subsequent write 
cycles the actual data transfer to the register can | 
take place (C/D Low). C/D is connected ‘to A1 of 
the Am8051. Otherwise, control or data write 


cycles are identical. 


output is enabled (OE Low). Write is enabled (WE . 


_ Low) during awrite cycle. 


In read cycles when AO is Low IC13 is enabled (OE 
Low, G High) to pass the data from the upper RAM 
(1C24) to the data port of the Am8051 (Port 0). In 
write cycles IC5 is enabled (OE Low, G High) to 
pass the data in the opposide direction from the 
Am8051 to the RAM. IC5 and 1IC13 can be 
replaced by a single, bidirectional latch (such as 
the 74LS646). For memory accesses only the 
transparent (driver) function is required.. However, 
- the latching function is required when the Am8051 
— accesses the 16-bit eons of the Am8052 (see 
below). 


Am8052 Memory Access 


The Am8052 performs only word read accesses. 
This means WE stays inactive High. Also, both 
RAMs are selected, and Apo is edie IC5 and 
'c1 3 are disabled. 


7-4 


How does the Am8051 load the 16-bit register via 

its 8-bit data bus? To accomplish this task, the 
Am8051 first latches the upper byte in IC5 (Ap 
Low, OE2 High, G2 High pulsed). In the next cycle, 


the Am8051 accesses the CRTC and loads both 


bytes into the Am8052 (Ag High, OE2 Low, G2 
Low). The upper byte is supplied by IC5, the lower 
byte is supplied by Port 0. 


Register Read - 


The Am8051 reads a 16-bit register in the reverse 
sequence. First it accesses the CRTC, to read 
both bytes. The lower byte is loaded into the 
Am8051 immediately, the upper byte is temporarily 
latched in IC13 (Ag Low, OE1 High, Gi High 
pulsed). In a sibseoucnt cycle the Am8051 can 
read the upper byte from IC13 (Ag High, Oct Low, 
Gi Low). » 


_ Port 1 Allocation 


P1.2 and P1.3 are High when the Am8s051 
controls the system bus. P1.4 and P1.5 control 
the keyboard logic. For normal operation these 
lines should be Low. OEN is active once per active ~ 
scan line and may be used to determine the beam 
position. Therefore, it is connected to the counter/ 
timer input of the Am8051 (TO). 


Control Logic 


Most of the control logic is integrated in a single 
PAL device, a PAL16L8, which controls the mem- 
ory selection, write enable, and output enable, the 
control for the data funneling (IC5 and IC13), and - 
the bidirectional data strobe (DS) forthe Am8052. 


Timing 


They Am8051 and the CRTC operate asyn- 
chronously.. The Am8051 should be operated at 
its maximum frequency to. achieve maximum 
performance. The CRTC is driven by the clocks 


provided by the Am8152A (Video System 


Controller). CLK; specifies the bus: clock (DMA. 


operation). CLKy determines the character clock 
rate. To support various screen formats - and, 
optionally, proportional spacing CLK1 controls the 
video timing. Both clocks are derived from the dot 
Clock, and. digitally synchronized during HBLANK 
to avoid screen jitter. The dot clock is 16 MHz. 
CLK1 is 4MHz (divide ratio of four). CLK2 cycle 


__ width varies from 4 to 12 dots, thus also resulting in 


a maximum frequency of 4MHz. 


Video Interface 
Basic Configuration 


The basic configuration consists of the Am8052 
(IC3), the Am8152A (IC12), a JEDEC pin- 


a 


PAL SPECIFICATION PROGRAM — 


PAL16L8 

PATO20 

8051-Am8052 INTERFACE CONTROLLER 
ADVANCED MICRO DEVICES, SUNNYVALE CA 


AQ 8=6/RD /BAI MEM. IO NC /WR 
Ne. /cs3. /cS4 /O82. G1 G2 /Ds 
OE = RD + DS*BAI | 
CS3. = /AO*RD*MEM*/IO*/BAI + 
/AO*WR*MEM*/IO*/BAI + 
| DS*BAI | 
CS4 = AO*RD*MEM*/IO*/BAI + 
AO*WR*MEM*/IO*/BAI + 
DS*BAI 
OE2 = /AO*WR*MEM*/IO + 
AO *WR*/MEM* IO 
/G1 = /MEM*/AO + MEM*AQ + 
-/I0*/MEM + IO*MEM + 
/RO*IO + AOQ*/IO + 
/RD 
/G2 = /MEM*IO + MEM*IO | + 
: /WR + AO 
CS = /MEM*IO*AO 


IF (/BAI) DS = RD + WR 


DESCRIPTION: 


compatible character font generator ROM (IC1), 
‘the dot clock oscillator (Y2), and the video cable | 
driver (IC19): All the remaining logic shown is > 
optional and implements the special functions 
outlined below. 


Horizontal Smooth Scroll 


The Am8052 only supports vertical smooth scroll 
directly. Horizontal smooth scroll can however be 
implemented quite easily. A dummy character is 
placed at the start of each character row. This 
dummy character is made invisible by blanking it - 
externally. The actual smooth scrolling is 
performed by modulating the width of this 
character. By shortening it, the character row 
moves left. Eventually, the leftmost character will 
disappear. At that time the first character is linked 


PAL DESIGN SPECIFICATION 
6/21/85 
JUERGEN STELBRINK 


NC 
/OE 


NC 
/CS 


GND 
Vcc 


OUTPUT. ENABLE OF RAMS 
UPPER (EVEN) RAM 


we 


we 


; LOWER (ODD) RAM. 


IC2, CPU WRITES EVEN RAM 
IC2, CPU WRITES AM8052 
Tcl - 


se 


IC2 


; AM8052 CHIP SELECT 
BIDIRECTIONAL DATA STROBE 


= 


— 1s 


The non-inverted equations for Gl and G2 are listed below: ; 


Bae es = /AO*RD*MEM*/IO + 
7 AQ*RD*/MEM*IO — 
G2 = /AO*WR*MEM*/IO + © 
/AO*WR* /MEM* IO 


; CPU READS EVEN RAM 
; CPU READS AM8052 

; CPU WRITES EVEN RAM 
; CPU WRITES AM8052 
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out, and the width of the dummy character is 


increased to it's original size. Then the smooth. 
scroll process is continued ‘until the second 


character is scrolled out completely, etc. 


The digital delay line consisting of four D-Flip-Flops 
(l1C22) delays BLANK to mask off the video stream 
(IC23). The delay is set to four CLK1 cycles (16 dot 
clocks). This covers the maximum length of the 
_ dummy character (12 dots) plus a delay of one 
CLK2 cycle (the first CLK2 oa is 4 dot clocks). 


Since the AM8152A involves one further dot clock 
propagation delay, the rightmost pixel of the 
dummy character is not masked off by the delayed 
BLANK: This pixel is blanked by loading a blank 
pixel (“1”) into the 12th position of the video shift 
register. 


The upper half of the video shift register is loaded 
with the falling edge of CLK2. While CLK2 is High, 
the character font generator output is three-stated 
(1C1). So, the pull-up resistors supply a High to the 
parallel input port, causing the Am8152A to always 
latch “1”s with the falling edge of CLK2. Since the 
character font is implemented in negative logic (for 
normal video REVERSE is active), “i”s are 
represented as blank pixels. 


Horizontal smooth scroll is discussed in more detail 
in a separate application note. 
Soft Loadable Character Font Generator 


Once horizontal smooth scroll is implemented, it 
takes only one additional latch (IC7) to integrate a 


in the Row. Redefinition Block provides the pixel - 


pattern of the character slice to be loaded. The. 


cursor attribute selects the scan-line to be loaded. 
Therefore, the Row. Redefinition Block defines the 
scan-line number to. be loaded (the cursor position 


within the character cell). The values for cursor start - 


and end must be equal to activate this. attribute for 
a single scan line only. 


Finally, the cursor  aniuteb bit within the character 
attribute word of the dummy character enables the 
loading process itself. 


Character Code Graphic 


An alphanumeric display system can implement bit- 
mapped graphic’ directly. One graphic 
implementation in an alphanumeric system treats 
the character code directly as bit-map. Each cha- 
racter code specifies eight consecutive pixels with- 


in a scan line. Therefore, the character code 


bypasses the character font generator via IC2 and 
supplies the pixel pattern to the parallel input of 
the shift register. Since each character row now 
consists of only one scan line, the Am8052 bus 
traffic is increased significantly and must be 


_analyzed carefully. 


soft loadable character font generator. Note, that 


this implementation differs from the method 
discussed in an earlier AMD application note. This 
implementation requires less hardware and also 
boosts the loading performance. Here, one slice of 
one character may be loaded per character row 
resulting in a loading rate of about two to three full 
character cells per frame (100 to 200 characters 
cells per second) assuming that 24 character rows 
are diplayed and that a al contains between 8 and 
12 Slices. 


In this implementation, the dummy character at the 
start of each character row performs one more task. 
It enables the loading process as well as providing 
all necessary information to perform the process 
itself. 


The character codé. of the arena character 
specifies the character to be loaded. The upper 
eight bits of the 10-bit row attribute word contained 


Row attribute bit 1 enables/disables this mode. For 
normal operation this bit is set to “O.” 


Italic Characters 


Italic type characters could obviously be supported 


by an additional (or larger) character font ROM or by 


reloading the character font RAM. But a small 
amount of special hardware can change straight 
characters to slanted characters. 


The italic mode is turned on by placing a unique 
shaped blank character into the character string. 
This character is wide on the top and narrow on the 
bottom. Once this character is placed in a character 
String all following characters will be tilted according 
the programmed shape of the “Italic On” character. 
The italic mode is. turned off by placing a blank 
character with the reversed shape into the 
character string. 


IC11, a 256°8 bit PROM implements this feature. 
The 8-bit address is assembled from the 4-bit scan 
line address and the 4-bit CLK2 divide ratio 
supplied by the Am8052. For the standard divide 


ratios from 4 to 12 the PROM just. passes the ~ 


supplied ratio through to the Am8152A (normal 


_ character mode). For four other ratios this device 
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becomes active. There, it modulates the width of 
the character with the scan line address to build 
the uniquely shaped characters: The following 
table lists the width values and shows how they 
affect the character diplay. 


Value Function 

0000 Italic On (9 pixels/character) 
0000 italic Off (9 pixels/character) 

0010 normal character (4 pixels wide) 

1010 normal character (4 pixels wide) 


1110 
1111 


Italic On (6 pixels/character) 
Italic Off (6 pixels/character)normal 





The italic mode is automatically reset at the end of a 
character row. Both characters controlling. italic 
mode have the same width as the standard 
characters. So, no width computations like in 
proportional spacing applications are required. 


Italic mode is turned on by placing a blank (201) in 
the string. This blank has the width value: 0000 or 
1110 depending on the chosen screen format. 


The italic mode is terminated by inserting a. blank 
with a width value: 0001 or 1111. 


7.5 USER'S MANUAL FOR THE 
LOW-COST, SMART TERMINAL 

Displays © 

Background Display 


usable rows stored in memory 


- 30 
128 — characters/row stored in memory 
80°24 characters in “normal” mode 
120*30 characters in “compressed” mode 


| Scrolls vertically and horizontally 
Message Display 


1 row (visible only when selected) 


128 — characters/row 
Scrolls only horizontally 


Window Display 


14 usable rows (7 visible when | 
selected) 
40 —_characters/row (40 visible when 
- gelected) 


_ Scrolls only vertically 


_ next row downward from the active row. 


There is only one cursor in the terminal; it is always 
in the active display. It may not be visible (e.g. 
beyond the currently visible bounds, or under the 
(visible) window while in the background display). 
The active position (i.e. cursor) indicates where the 
next graphic character which this system receives 
will be stored. 


Controls 


There are five classes of controls: normal ASCII 
control characters, escape sequences, extended 
control characters, standard control sequences, 
and private control sequences. 


Normal CO Control Characters 


These are the subset of the ASCII X3.4 control 
characters which we have implemented. 


Backspace (BS) 


Moves the active position one column left in the 


active row, except when the cursor is already in the 


leftmost column in the display. This control'does 
not cause scrolling. 


Carriage Return (CR) 


Moves the active position to the first column in the 
active row. This contro! does not cause scrolling. 


New Line (NL) 


Moves the active. position to the first column in the 
If the 
active row is the bottom row of the display then a 
blank row is inserted at the bottom of the display 
and the top row is deleted. This. has the 
appearance of scrolling the entire display upward 
one row. The next row, to which the active 


position is moved, is the new bottom row. 


This control has no effect when the message 
display is active. 


Escape (ESC) 7 


Introduces escape sequences defined in the ANSI 
X3.64 extension. 


eocepe pequences 


These are seqences ‘defined i in ANSI X3.64 that 


consist of an escape character followed by a final 


character. They are parameterless controls. 
‘ \ x 


Reset to Inital State (RIS)—ESC c 


Resets the terminal to a blank background display, 
in small display mode, scrolled all the way up and to 
the right, with the active position at the first column 
in the ‘seventh row (top row on the monitor 
screen). The graphic | rendition, character blink 
rate, smooth scroll rate and cursor appearance are 


leftmost column. 


given their initial values. The Vertical Editing Mode 


(VEM), Display Width Mode (AMDDWM), Scroll 
Mode (AMDSCM) and Screen Polarity Mode 
(AMDSP\W) are all reset. The message and window 
displays are also blanked as well as being made 
invisible. The background display is active and the 


character generator is reloaded with its initial 


patterns, 


J 


~ Control Sequence Introducer 
(CSI)—ESC[ 


Introduces control sequences defined in the ANSI 
_ X3.64 extension. It also introduces the private 
control sequences .that are implemented in accor- 
=dance with that standard. 


Extended Control Characters 


parameter, without altering its vertical position. An— 


attempt to move.the active position beyond the 


leftmost column in the. display leaves it at the 
A default: parameter causes 
movement one column leftward, except from the © 
leftmost column. This control does not cause 
scrolling. It may move the cursor to a position 
where it is invisible. 


Cursor Down iad ia PnB 


Moves the active position downward the muRber 
of rows specified by the single numeric parameter, 
without altering its horizontal position. An attempt 
to move the active position beyond the bottom row 
of the display leaves it at the bottom row. A default. 
parameter causes movement one row downward, 
except from the bottom row. This control does not 
cause scrolling. It may move the cursor to a 
postion where itis invisible. 


Cursor Forward (CUF)—CSI Pn C 


Moves the active position the number of columns. 


rightward specified by the single numeric para- 
meter, without altering its vertical position. An 


‘attempt to move the active position beyond the 


The Control Sequence Introducer (CSI). is also 


, available as a single, 8-bit control character (x‘9B’). 
It performs the same function as the escape 
sequence described above. 


Extended Control Sequences 


These are sequences introduced with the Control 
Sequence Introducer (CSI) described above. 
They may contain parameters and intermediate 
characters and end with a final character. 


Parameters may be interpreted either as decimal 


numbers or as special selectors that depend on 
the particular control for their meaning. A default 
parameter is one that is missing or is specified with 
a value of zero. 


Cursor Backward Ne mn Pn D 


Moves the active position left by- the number of 
columns specified by the single numeric 


rightmost column in the display leaves it at the 
rightmost column. A default parameter causes 
movement one column rightward, except from the 
rightmost column. This control does not cause 
scrolling. It may move the cursor to a position 
where it is invisible. 


Cursor Position (CUP)—CSI Pn ; Pn-H 


Moves the active position to the row and colufnn 
specified by the two numeric parameters. The first 
parameter specifies the row; a default causes 
movement to the top row. An attempt to move the 
active position beyond the bottom row in the 
display leaves it at the bottom row. The. second 
parameter specifies the column; a default causes 
movement to the leftmost column. An attempt to 
move the active position beyond the rightmost 
column in the display leaves it at the rightmost col- 
umn. This control does not cause scrolling. It may 
move the cursor to a position where it is invisible. 


Cursor Up (CUU)—CSI Pn A- 


Moves the active position upward the number of 
rows specified by the single numeric parameter, 
without altering its horizontal. position. An attempt 


to move the active position beyond the top row of 
the display leaves it at the top row. A default 


parameter causes movement one row upward, 


except from the top row. This control does not 
cause scrolling. It may move the cursor to a 
position where it is invisible. 


Delete Line (DL)—CSI Pn M 


Deletes the number of rows specified by the single 
numeric parameter. If the Vertical Editing Mode is 


reset then the active row and rows below it are | 


discarded and any remaining rows at the bottom of 
the display are shifted upward with blank rows 
being shifted into the display below them. The 
active position remains in the same horizontal pos- 
ition within the highest row that was shifted (which 
may be blank). — If VEM is set then the active row 
and rows above it are discarded and any re-maining 
rows at the top of the display are shifted downward 
with blank rows being shifted into the display 
above them. The active position remains in the 
same horizontal position within the lowest row that 
was shifted (which may be blank). An attempt to de- 
lete more rows than is possible blanks the display 
from, and including, the active row through the bot- 
tom or top row, depending on the state of VEM. A 
default parameter causes one row to be deleted. 


Erase In Display (ED)—CSI Ps J 


Blanks a region, of the display, specified by the 
~ selective parameter. A default parameter causes 
the region from, and including, the active position 
through the end of the display to be blanked. The 
active position does not change. 


Parameter — Meaning 
0 Blanks the active’position and all 
positions to the end of the display 
1 Blanks from the beginning of the 
display up to, and including, the 
active position 
2 Blanks the entire display 


“Parameters other than those listed above are ignored. 


‘Erase In Line (EL)—CSI Ps K 


Blanks a region of the active row specified by the 
selective parameter. A default parameter causes 


the region from, and including, the active position. 


through the end of the row to be blanked. The 


' Parameter 


active position does not change, 


Parameter 


Meaning 
0 Blanks the active position and all 
positions to the end of the row 
1 Blanks from the beginning of the row 
up to, and including, the active 
position 
2 Blanks the entire row 


' Parameters other than those listed above are ignored. 


Insert Line (IL)—CSI Pn L 


Inserts the number of blank rows specified by the 
single numeric parameter. If the Vertical Editing 
Mode (VEM) is reset then the active row and all 
rows below it are shifted downward. The active 
position remains in the same horizontal position 
within the first (highest) blank row. If VEM is set 
then the active row and all rows above it are shifted 
upward. The active position remains in the same 
horizontal position in the last (lowest) blank row. 
An attempt to insert more rows than are being 
shifted blanks the display from, and including, the 
active row through the bottom or top row, 
depending on the state of VEM. Rows shifted out 
of the display are discarded. A default parameter 
causes one blank row to.be inserted. 


Reset Mode (RM)—CSI Ps | 


Resets the modes indicated by the selective 
parameters to their initial states. Four modes have 
been implemented. When Vertical Editing Mode 
(VEM) is reset the Insert Line (IL) and Delete Line 
(DL) controls operate below the active row. When 
Display Width Mode (AMDDW\M) is reset the normal 
display mode (80 characters per row and only 24 
rows displayed) is in effect. When Scroll Mode — 


_ (AMDSCIM) is reset then jump (i.e. non-smooth) 


scrolling is affected. When Screen Polarity Mode 
(AMDSPM) is reset then normal characters are 
shown as: light on dark. A sequence with no 
parameters has no effect. 


| Meaning . 
7 VEM (insert/delete below active row) — 
23 AMDDWM (normal display mode) 
24 . AMDSCM (jump scrolling) A 
25 AMDSPM (light on dark characters) 


Parameters other than those listed above are ignored. 


Scroll Down (SD)—CSI Pn T | 


Scrolls the display downward the number of rows 
specified by the single numeric parameter. An 
attempt to scroll the top row of the display 
downward beyond the top row on the screen 
leaves it at the top row. A default parameter 


causes the display to scroll down one row, unless . 


the top row of the display is already at the top row 
onthe screen. 


This control has no effect when the message - 


display is active. 


Select Graphic Rendition 
| (SGR)—CSI Psm 


Selects the attributes, with which subsequent 
characters will be displayed, as specified by the 
selective parameters. A choice between two fonts 
is also selectable. A sequence with no parameters 
does not change attributes. 


Parameters Meaning. 
0 Initial rendition: steady, normal 
7 intensity, not underlined, not 
crossed out, normally aligned, 
_ positive image, primary font 
1 Bold or increased intensity 
4 Underlined 
5 Blinking 
i Negative image 
9 Crossed out (legible but marked as 
to be deleted) 
- 10 Primary font 
4 Secondary font 
22 Normal intensity 
24 Not underlined © 
25 Steady (not blinking) 
27 Positive image 
29 Not crossed out 
291 | Superscript alignment 
292 Subscript alignment 
293 Normal alignment 


Parameters other than those listed above are ignored. 


Scroll Left (SL)—CSI Pn SP @ 


‘Scrolls the display leftward the number of columns 
specified by the single numeric parameter. An 


attempt to scroll the rightmost column of the | 


display leftward beyond the rightmost column on 
the monitor screen leaves it at the rightmost 
column. A default parameter causes the display to 
~ scroll left one column, unless the rightmost column 


of the display is already at the rightmost column on . 
the monitor screen. | 


This control has no effect when the window display 
is active.. 


Set Mode (SM)—CSI Ps h 


Sets the. mode indicated by the selected 
parameters to their alternate states. Two modes 
have been implemented. When Vertical Editing 
Mode (VEM) is set the Insert Line (IL) and Delete 
Line (DL) controls operate above the active row. 
When the Display Width Mode (AMDDW\W) is set 
the compressed display mode (120 characters per . 
row and all 30 rows displayed) is in effect. When 
the Scroll Mode (AMDSCM) is set then smooth 
scrolling is used. When the Screen Polarity Mode 
(AMDSPM) is set then normal characters are 
shown dark’ on -light. A sequence with ‘no 
parameters has no effect. 


Parameters Meaning 
7 VEM (insert/delete above active row) 
23 AMDDWM (compressed display 
~mode) 
274 = AMDSCM (smooth scrolling) 
25 _AMDSPM (dark on light characters) 


Parameters other than those listed above are ignored. 


Scroll Right (SR)—CSI Pn SP A 


Scrolls the display rightward the ‘nnbet of 
columns specified by the single numeric para- 
meter. An attempt to scroll the leftmost column of 
the display rightward beyond the leftmost column 
on the monitor screen leaves it at the leftmost 
column., A default parameter causes the display to 


- scroll right one column, unless the leftmost column 


of the display is already at ae leftmost column on 
the monitor screen. | 


This control has no effect when the window display 
is active. 


Scroll Up (SU)—CSI Pn S$ 


Scrolls the display upward the number of rows 
specified by the single numeric parameter. - An 
attempt to scroll the bottom row of the display 
upward beyond the bottom row on the monitor 
screen leaves it at the bottom row. A default 
parameter causes the display to scroll up one row, 
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unless the bottom row of the display is already at 
the bottom on the monitor scréen. 


This control has no effect when the window display 
is active. 


Private Control Sequences 


These are sequences that are introduced by the 
Control Sequence Introducer (CSI). They may 
contain parameters just like the standard sequen- 
ces, but their final characters are in the set which 
the standard has reserved for private use. 


Character Blink Rate (AMDCBR)—CSI Psu 


Selects the rate and duty cycle, for characters 
displayed with the blink attribute, as specified by 
the selective parameters. Currently blinking charac- 
ters, as well as those subsequently displayed, will 
reflect the selection made by this control. A de- 
fault parameter selects the fastest blink rate and a 
25%-75% duty cycle. , 


Parameters Meaning 
0 Initial character blink: fastest, 
25%—75% cycle 
11. Blink with 50% active, 50% inactive 
cycle 
12 Blink with 25% active, 75% inactive 
cycle’ 
20 Fastest blink rate 
21 Fast blink rate 
22 Slow blink rate 
23 _ Slowest blink rate 


Parameters other than those listed above are ignored. 


Load Font-Cell (AMDLFC)—CSI Pn... Pn~ 


Programs one cell of the character generator with 
the pattern specified by the numeric parameters. 
When in “normal” display mode: the 7°9 display 
cells are programmed, otherwise the small display 
cells (5x7) are programmed. The first parameter 
specifies which character cell is to be programmed. 
There are 256 chracter cells specified in the range 
0 through 255, inclusive. All cells except that at 
location 32 can be programmed; this is always a 


blank and cannot be changed. A default for this | 


parameter will cause this control to be ignored. 
The second parameter specifies at which character 
cell slice programming is to. begin. Slices are 


numbered downward beginning with zero. Slices 


’ above the first slice are automatically blanked. A 


default for this parameter causes the programmed _ 
pattern to begin at the top slice in the character 
cell. The rest of the numeric parameters each 
represent a slice of the character pattern. They are 
decimally encoded byte values for the desired 
eight-bit slices, with the most significant bit at the 
left side of the character and the least significant bit 
at the other side of the character cell. In small. 
display mode, the entire slice (all eight bits) are 
shown with an additional blank pixel after each 
character. In large display mode, only the most sig- 
nificant six bits are shown and there is no additional 
blank pixel. A default for a pattern parameter | 
causes the slice to be blanked. As many slices are 
programmed as there .are parameters supplied, 
down to the bottom of the character cell. Any un- 
programmed slices below the last programmed 
slice are automatically blanked. — 


Select Active Display (AMDSAD)—CSI Psp 


Makes one of the background, message or 
window displays the active display. The active dis- 
play is where the characters being received are 
stored and where the controls being received per- 
form their functions. The displays each have their 
own active position and current graphic rendition. 
The cursor is shown at the active position of the ac- 
tive display, provided that active position is visible. 
A default parameter makes the background display 
the active display. This control does not affect 
message and window display visibility. 


Parameter Meaning 
0 _ Makes the background display active 
(default) 
1 Makes the message display active 
2 Makes the window display active 


Parameters other than those listed above are ignored. 


Select Cursor Appearance: 
(AMDSCA)—CSI Ps v 


Selects the appearance of the cursor, which marks 
the active position, as specified by the selective 
parameters. The fundamental form of the cursor, 
as well as whether or not it blinks and at what rate, 
can be changed. A default parameter selects a 
steady, reversed block covenng the entire 
character cell. 
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Parameters | ‘Meaning | 
0 Initial cursor: steady, reversed, full 
block 
1 Reversed block covering entire 
‘character cell 
2 Reversed block covering lower half 
, of character 
3 Solid block covering lower half of ' 
| character 
4 Underscore 
5 Thick underscore 
10 ‘ Steady, non-blinking 
11 Blink with 50% active, 50% inactive 
. cycle | | 
12 Blink with 25% active, 75% inactive 
cycle 
20 ’ Fastest blink rate 
21 Fast blink rate 
22 Slow blink rate 
23 Slowest blink rate 


Parameters other than those listed above are ignored. 


Smooth Scroll Rate (AMDSSR)—CSI Ps t 


Selects the rate at which both vertical and 
horizontal smooth scrolling occurs as: specified by 
the selective parameters. If more than one 
parameter is specified then the last one has 
precedence. A default parameter selects one 
scanline/pixel penne: 


Parameter Meaning 
0 Initial scroll rate: one scan line/pixel 
perframe . 
- 4 One scan line/pixel per frame 
2 Two scan lines/pixels per frame 
3 Three scan lines/pixels per frame 
4 Four scan lines/pixels per frame 
5 Five scan lines/pixels per frame 
6 Six scan lines/pixels per frame 
7 Seven scan lines/pixels per frame 
8. Eight scan lines/pixels per frame 
12 One scan line/pixel every two frames 
13 One scan line/pixel every three 
frames 
14 One scan line/pixel every four frames 
15 One scan line/pixel every five frames 
16 One scan line/pixel every six frames 
17 One scan line/pixel every seven 
frafnes 
18 | One scan line/pixel every eight 
frames 


Parameters other than those listed above are ignored. 


Select Window Visibility 
(AMDSWV)—CSI Ps rT 


Makes the window display either visible or invisible 
as specified by the selective parameter. A default 
parameter makes the window display invisible. 
This control does not affect which display is active. 


Parameter Meaning 
0 Makes the window display invisible 
. (default) 
1 Makes the window display visible 


Parameters other than those listed above are ignored. 
Select Message Visibility (AMDSMV)—CSI Ps q 


Makes the message display either visible or 
invisible as specified by the selective parameter. A 
default parameter makes the message display 
invisible. This control does not affect which display 
is active. 


\ 





Parameter Meaning 
0 Makes the message: display invisible 
(default) 
1 Makes the message display visible 


Parameters other than those listed above are ignored. 


7.6 LOW-COST TERMINAL COMPARISONS 


This document contains two tables comparing the 
features of four terminals with the implemented 
Low-Cost, Smart Terminal based on the Am8052/ 
Am8152A chip set. The purpose is to clarify the 


relationship of this terminal to other well known 


alphanumeric terminals. The tables include the 
DEC VT100 and VT220 and the IBM 3101. All but 
the IBM terminal are ANSI X3.64 compatible term- 
inals. The IBM terminal claims to adhere to an ear- 
lier ANSI and ISO specification; it is similar in some 
respects to the ADDS Viewpoint or the DEC VT52. 


It is very important to understand that the ANSI 
specification does not define the characteristics of 
any specific terminal, nor does it require any 
minimum implementation. Rather, it defines the 
method of encoding control information which may 
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be sent to, or received from, a_ terminal. 
Consequently, a terminal may conform to ANSI 
X3.64 whether or not it has the ability, for example, 
to insert a line in a display. If an ANSI X3.64 
compatible terminal does have the ability to insert a 
line in a display, however, then the control which is 
sent to perform a line insertion must be encoded 
as specified in the ANSI standard. 


In.a practical sense, a user of ANSI terminals can 


write software which performs the most elementary 
operations (such as cursor positioning) with 
confidence that they will work on any conforming 
terminal. There are some slightly more advanced 
operations (such as insertion and deletion) which 
may or may not be included in a given terminal, but 
if present will always be encoded in the standard 
manner. The user may write “portable” programs 
which make use of these functions only if he 
checks carefully for their support on any terminals 
he wishes to use. Finally, there will be many 
unique operations for a given terminal (such as 
window support) which will be represented by 
“private” extensions that conform to the ANSI 


standard. User programs which make use of such 


operations become bound to:a particular terminal 
or its emulators. 


From the user's viewpoint, it would be better if 
there were some truly standard specification of a 
terminal, for which he could write programs with the 
expectation that such programs would then be 
completely “portable” among ANSI compatible 
terminals. Unfortunately, this is not the situation. 


Only the method of encoding control information is - 


standardized, not the characteristics or capabilities 
of a terminal. Still, this is better than the complete 
absence of standardization. Programs can be 
_ written which are reasonably portable and standard 
modules for sending controls to a terminal can be 
developed. Furthermore, high-level software 


simulations of more advanced features, which may 


be missing in some terminals, can be written to.use 
the simpler features which are present. For these 
reasons, it is appropriate for developers of new 


terminals to conform to the ANSI X3.64 standard. 


The Low-Cost Smart Terminal, implemented with 
the Am8052/Am8152A chip set on an. IBM-PC 
board, does have ANSI X3.64 compatible control 
definitions. Its relationship to other terminals can 
only be determined by detailed analysis of the 
characteristics of these terminals. The two tables 
which form the bulk of this document provide a first 
level analysis. The first table is a.summary of 
groups of features. The second is a detailed listing 
of individual controls. 


In viewing this comparison, certain general 
statements can be made. These are: 


1. The implemented terminal handles the most 
common forms of cursor positioning and 
character display as do all the other terminals. 


2. The implemented terminal includes advanced, 
yet fairly common features such as character 
assigned attributes, row insertion and deletion, 
-smooth scrolling and a window. The criteria for 
including these features was that they should 
relate directly to capabilities of the Am8052. No 
advanced features have been included “for 
their own sake” or for compatibility with any 
other terminal. Such features, since they do 
not relate to the Am8052, would be primarily a 
software exercise. | 


3. The implemented terminal includes some 

_ “private” controls .for the purpose of 
demonstrating unique hardware capabilities 
such as varying the rate of smooth scrolling, 
smooth scrolling either window or background | 
without affecting the other and horizontal 
smooth scrolling. 


‘The comparison reveals the original design intent, 


that it should demonstrate the applicability of the 
Am8052 to a low-cost terminal while also revealing 
the advanced features that the use of an Am8052 


| could bring to such a product. 
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SUMMARY TABLE 




















_ Am8052 VTI00 vT220 2s BM 
1. Simplecursormovement | YES YES YES sO 
and positioning. | _ | : 
2. Additionalcursor _ IND &RI ‘IND &RI within arow 
-.. movement ss a only only | 
3. Cursor tabulation oe forehrz =» ~—s fore hrz - fore & 
movements _— s. Pe> only. _only back hrz 
4. Tabulation ~ hard setup simple set & ‘simple set & 
-. control 7 - | only clear clear » 
5. _ Insert and Deletes YES _ . YES - - YES 
~ . by Row : | 
6. Insert and - - YES . YES 
Deletes 
by Character 
7. Unconditional display & line display & line hit display & line . display line &. 
Erasures & chr & chr | field 
8. Conditional ee - _ display : display 
Erasures . & line ' | 
9. Vertical smooth — smooth smooth  . — jump 
Scrolling only & jump | & jump only 
10. Horizontal smooth = 7 - - 
Scrolling only | 
11. Superscripts ; YES - _ ~ 
and Subscripts 
12. Modes . some | well stocked well stocked _ 
7 : ‘but most hardware but most hardware 
dependent dependent 
13. Character Display YES _YES YES YES 
Attributes a 
14. Selectable Fonts YES YES | YES YES 
15. AlterableFonts YES | = YES - 
16. Windows single fixed simple scrolling simple scrolling - 
. region region 
17. Am8052 Dependent special controls = - 
Features defined 
18, Double Height/Double Width - YES YES _ - 
Characters : 
. 19. Diagnostics and Reports. - YES YES | cursor pos 
only 
20. Miscellaneous © ‘ reset ; reset comm & reset comm & comm 
| specials - . specials 
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DETAILED TABLE 


Am8052 VT100 VT220 IBM 
1. Simple cursor movement and positioning 


Cursor Back YES YES YES YES 


Cursor Down YES YES YES YES 
Cursor Forward YES YES ‘ YES YES 
Cursor Position YES YES "YES YES 
CursorUp » YES YES | YES YES 
Backspace YES YES YES YES 
Carriage Return YES YES YES YES 
New Line YES YES » YES - YES 
Line Feed | YES YES YES . YES: 
Horz Vert Pos j 1) YES YES - 


2. Additional cursor movement 











Horz Pos Abs 1) - - YES 

Index 1) YES YES - 

Reverse Index 1) YES YES . - 

3. Cursor tabulation movements 

Horizontal Tab ee 1) YES YES YES 

Cursor Backward Tab | 1) . - - YES 

4. Tabulation control 

Clear Tab 1) _ | YES - YES 

Set Horz Tab 1) - .YES YES 

5. Insert and Deletes by Row 

Delete Line YES é YES YES 
‘Insert Line ; YES _ _ YES YES 

6. Insert and Deletes by Character 

Insert Character 1) - YES YES 

Delete Character | 1) - YES YES 

7. Unconditional Erasures 

Erase Display YES YES ==—™—=«CSY'ESS - YES 

Erase Line | YES YES . YES YES 

Erase Field 1) - - YES 

Erase Character . Te - - YES | - 

8. Conditional Erasures | 

Erase Display » > 4) - YES | YES 

Erase Line 1). - YES a 
| 9. Vertical Scrolling 

Scroll Down YES YES | YES =. 
Scroll Up YES YES YES YES 





“10. Horizontal Scrolling 


oor inn at A RE SE 


Scroll Left | YES _ on = 
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Scroll Right 


11. Superscripts and Subscripts 


Partial Line Down 
Partial Line Up 


42. Modes 


Reset Mode 
Set Mode 
Send-Receive 
LineFeed/NewLine 
Insert/Replace 
ANSIVT52 
Auto Repeat 
Cursor Key Usage 
Keypad usage 
Origin Location 


Normal/Reverse Display 


Interlace Display 


- 80/132 Column Display (120) 


Jump/Smooth Scroll 
‘AutoWrap 

Print Form Feed 
Print Extent. 

Text Cursor 


13. Character Display Attributes 


Select Grph Ren _ 
Start Field 


14. Selectable Fonts 


Shift Out 

Shift In 

Single Shift Two 
Single Shift Three 
Select Character Set 


15. Alterable Fonts 
Load Font 
16. Windows 


Write to Window 


Make Window Visible 


Make Window Invisible 


17. Am8052 Dependent Features 


Character Blink Rate 
Select Cursor Style 
Smooth Scroll Rate 


18. Double Height/Double Width Characters. 


Double-Width Line 
Double-Height Line 


: 


~ Am8052 - 


YES © 


YES 
YES 


YES 
YES 
1) 


2) 
YES 


YES 
YES 
YES 


YES 


YES 


YES 


1) 
1) 


~ VT100 


YES 
YES 


YES 


YES | 
YES 
YES 
YES ' 
YES 
YES 
YES © 
YES 
YES 
YES 


YES 


YES 
YES 


YES 


YES 
YES 





VT220 


YES 


YES 
YES 
YES 
YES 
YES 
YES 
YES 
YES 
YES 
YES 


YES 


YES 
YES 
YES 
YES 
YES 


YES 


YES 
YES 
YES 
YES 


YES 


YES . 
YES 


_ 


YES | 


IBM 


YES 


YES 
YES 


aS 





| Am8052 VT100 VT220 IBM 





19. Diagnostics and Reports : 





Screen Alignment 1) YES YES | _ 
Identify Terminal 1) © YES YES - 
Confidence Test 1) ~ YES YES - 
Cursor Position 1) YES YES YES 
Report Term Params 1) YES YES ° - 
Request Term Params 1) YES YES - 





20. Miscellaneous - 














Reset Init State YES YES YES - 
Bel 2) YES YES YES 
Enquiry 1) YES. YES - 
Xon 1) YES YES YES 
Xoff 7 1) YES YES YES : 
Cancel 1) YES . YES YES 
Substitute 1) YES YES © - 
Device Attribute 1) — YES YES - 
Restore Cursor 1) YES YES - 
Save Cursor | 1) YES : YES - 
Load LEDs 1) YES - - : 
Notes: 1) software driver not implemented, but can be easily added x 

2) requires additional hardware support 


—) not supported 
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Figure 7-1 Am8052 Terminal Board System Interface . 
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Figure 7-1 Am8052 Terminal Board System Interface (Continued) 
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Figure 7-2. Am8052 Terminal Board Video Interface 
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Figure 7-2 Am8052 Terminal Board Video Interface (Continued) 


7-21 


TxD 


U4 
8751 Pi 





Vec 


J2 
9 PIN 
CONNECTOR 


7-22 





J 


O 


AD? 
ADs 
ADs 
ADs 
AD3 
ADe 
AD; 
ADo 


(SHEET 1) 


PSEN (SHEET 1) 


Vcc 
Ai 


Ais 
Ai2 
Any 
Ato 
As 
As 
A7 
Ae 
As 
Aq 
As 


Aa 


Ay 
Ao 


le 


(SHEET 1) 


APPENDIX A 


Mixing Data Paths Expand Options In System Design 
- Mark S. Young and James R. Williamson 


a 


SYSTEM DESIGN / (iTIZBRAIED GIREUITS 








© Copyright Computer Design Publishing Co., January 1985. 
All rights reserved. Reprinted by permission. . 


MIXING DATA PATHS 
EXPANDS OPTIONS IN | 


SYSTEM DESIGN 


Chip designers are creating powerful CPUs and peripherals 
with 16- and 32-bit parts. Mixing these with 8-bit parts © 
overcomes limitations imposed by established designs, 
incomplete families, and software incompatibility. 


7 


by Mark S. Young and 
James R. Williamson 


Integrating 16- and 32-bit peripherals and CPUs 
into 8-bit designs, at the simplest level, means 
separating the control and data paths from new 
peripherals and the systems. Mixing different data 
path widths and control protocols, however, makes 
possible major improvements in function, perfor- 
mance, and cost. 

The price/performance curve of VLSI chips, for 
example, allows designers to obtain more and bet- 
ter functions for the same amount of money every 
year. Alternately, the functionality of a device:can 
remain constant while the price falls. | 

Moreover, these new devices with wider data paths 
can extend the life of older designs. For example, 
many of the most popular personal computers today 
use the 8088 microprocessor and, therefore, are con- 
strained to an 8-bit data path. Designers of add-on 


accessories for these personal computers prefer the: 


Mark S. Young is a product planning engineer at 


Advanced Micro Devices, Inc (Sunnyvale, Calif). He — 


holds a BA in computer science from the University 
of California at Berkeley. 


James R. Williamson is an applications engineer at 
AMD. He holds a BS in electrical engineering from 
the California State Polytechnic University, Pomona.. 


newer 16-bit peripherals. These peripherals will let 
users preserve their software investments, improve 
performance, and stave off obsolescence. 

Mixing different data path widths can also enhance 
new designs. For example, it is less expensive to use 
an 8-bit bus in a‘new design because the memory 
requirements are. generally cheaper. Only half as 
many dynamic RAMs are necessary for the same 
number of kilobytes of memory. In addition, an 
8-bit bus needs much less control and support logic. 
Designers can mix smaller data path peripherals with 
wider data path CPUs. This allows them to introduce 
systems based on the newer, more powerful 32-bit 
CPUs even before 32-bit peripherals are available. 

Designers can. use this mixing method to obtain 


wider data paths from existing designs until a new 


system design is warranted. They can also use parts 
in unexpected applications. For example, cost- 
conscious terminal manufacturers might want to use - 
the Am8052/8152A chip set (the 8052 is an advanced 
CRT controller andthe 8152A is a video system con- 
troller) in new terminals based on the relatively 
inexpensive 8051 microprocessor. Mixing the 8-bit, 
single-chip microprocessor with the 16-bit CRT con- 


troller allows designers to maximize the cost/ perfor- 


mance ratio of the terminal. 

Mixed data path widths can improve bus utiliza- 
tion as well. A 16-bit peripheral in a 32-bit system 
only occupies half the data bus for data transfers. 
If the designer mixes the data paths correctly, how- 
ever, the 16-bit peripheral could transfer data as 
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The state flow control diagram for a bus master read 
operation illustrates the control sequence employed 
by the 8/16-bit bus controt logic. 


32-bit chunks and improve bus ef liclency by 100 per- 
cent for that peripheral. 

Two central concerns stem from mixing devices 
_ that communicate over. different-sized buses. The 
first problem results when two devices communicate 
on a ‘‘common’’ data bus. Consider, for example, 
a 32-bit system utilizing 8- and 16-bit peripherals. 
Overcoming the mismatched data paths requires 
‘some form of controlled multiplexing/demultiplexing 
of the different data paths. In addition, extra con- 
trol signals for partitioning the 32-bit word into 8-, 
-16-, and 32-bit chunks may be required. 

Many 16-bit CPU-based systems that use 8-bit 
peripherals normally use just the lower 8 bits of the 
data bus to transfer data to and from the peripheral. 
This method does not work in systems using 16-bit 
peripherals and 8-bit CPUs, however, and it tends 
to break down in systems with 8-bit peripherals hav- 
ing bus master capability. 

A bus multipléxing method involves multiple 
transfers when taking data from or adding data to 
a mismatched data'bus. For example, before a 16-bit 
peripheral can transfer data over an 8-bit bus, the 
16-bit data must be divided into two 8-bit chunks. 
It is then transferred sequentially. First, the lower 
8 bits are transferred out on the bus: Then, in the 
next transfer cycle, the upper 8 bits of the 16-bit 
word are sent out. The major difference in the oppo- 
_ site case—a bus read operation from an 8-bit bus 
to a 16-bit device—is that the first byte read from 


the system must be latched. Once the second byte: 


has been fetched, the 16-bit peripheral reads in the 
assembled 16-bit (2- byte) word. Additional provi- 
sions may be needed when the 16-bit Se only 
- wants to access a-single byte. - 


The other major problem in mixed data: path . 
transfers is the actual data read/write operation. The 
nature of the multiple transfer forces designers to 
guarantee.that the stretched transfer will occur and 
that it will not be interrupted. Two aspects of stretch- 
ing the transfer cycle from or to the peripheral illus- 
trate the complexity of this problem. 

The first case, when the peripheral is the bus - 


_ master, is the simplest..A 16- -bit peripheral holds its 
data available for what normally would be two com- 
plete bus transfer cycles. This function can be per- 


formed when the transfer acknowledge signal to the 
peripheral is delayed. If the data was latched instead 
of holding the peripheral in a multiple word transfer, 


however, the device could: try to send the next 16-bit 


data word and its ‘‘new’’ address. The procedure 


' of latching the data and releasing the peripheral 


should not be used, therefore, because it may inter- 


fere with the addressing of the remaining (pending) 


8-bit transfer. 

Whenever a device acts as a bus slave to a CPU 
that cannot access-the device’s natural word width 
in a Single operation, a different constraint appears. 
The sequence must be set up so the peripheral cannot 
obtain the bus while the CPU is in the middle of a 


slave read/write operation. In a typical system, the — 


CPU is the last device in the interrupt queue. It is 
possible for the peripheral to become bus master 
between the first and second read operations and in- 
validate the results of the first read operation in a 
realtime system. This is because an 8-bit CPU would 
have to perform two consecutive read operations to 
examine a 16-bit peripheral control register. — 
This function can be handled two different ways. 
If the CPU has a bus lock instruction, as intheiAPX - 
family of CPUs, the programmer must use one of 
these instructions before the CPU accesses the 
peripheral. Alternately, the CPU needs to disable 
the arbitration logic while it is performing the unin- 
terruptible access with the 16-bit peripheral. 


Crucial cycte 

The uninterruptible word transfer cycle is crucial 
for maintaining the integrity of the data transferred. 
When either the CPU or a peripheral on the bus 


makes an access using the 8/16-bit control logic, it 


must complete the larger device’s word access before 


‘relinquishing the bus. If this requirement is not met, 


a transfer’s integrity can be violated easily by some 
other device. This interrupts the transfer, and cor- 


_rupts or aborts the multiplexing sequence. 


To illustrate this point, consider a system consist- - 


ing of an 8-bit CPU and several 8- and 16-bit periph- 


erals. Assume one of the peripherals is executing a: | 
block transfer of 16-bit data onto the 8-bit bus. If 
the CPU interrupted the transfer in order to poll the 
peripheral during a half-word transfer, two undesir- 
able events would occur. Either the multiplexing 
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sequence would be damaged irreparably when the. 


CPU polled the peripheral, or the CPU would read 
garbage from the peripheral. 

Designing the control interface to allow mixing 
of 8- and 16-bit peripherals requires attention to the 
data and control flow. During a write operation, the 
data is written out sequentially: the lower byte comes 
before the upper byte (or vice versa). The read oper- 
ation differs only because the data bus is 8 bits and 
because it forgets the last byte transferred; it knows 
the current byte only. Hence, the interface requires 
that one of the bytes be latched until the full 16-bit 
word has been assembled. 

The slave mode of operation works almost the 
same as the peripheral bus master mode. The single 
exception is the slave write operation. When the 
interface is defined, the designer must make a con- 
scious choice about Which byte (upper or lower) to 
latch during peripheral read operations (or con- 
versely, slave peripheral write operations). Once this 
decision has been made, the CPU must always access 
the latched data byte first (during a slave write) and 
then access the non-latched byte to complete the 


transfer. This restriction is minor, requiring no extra . 


software overhead. It could affect the ease of the 
programmer’s coding if not handled properly, how- 
ever. For example, if the programmer used a com- 
piler to generate the software for the system, extra 
care may be necessary to ensure the compiler gener- 
ates the correct addressing sequence. 

An alternative solution would be to latch both the 
upper and lower data bytes. In this. case, however, 
the cost of the interface would increase, as would 

the complexity, with no appreciable gain. The con- 
trol flow in these designs derives from two differ- 


"STATE FLOW EQUIVALENTS S0 
| 


ent sources: the state control flow itself and the 16-bit 
peripheral interfacing with the 8-bit bus. A state dia- 
gram can be used to specify how uninterrupted word 
transfers will occur and how the upper and lower 
byte address is generated. 

In addition, the specific bus timing of the periph- 
eral and the data bus must be examined to quantify 
the state control flow. These timing, specifics also 
provide information on data latching, read/write 
control strobes, and addressing to and from the 
peripheral. The state control flow is divided into four 
operations: bus master read, bus master ws slave 
read, and slave write. 

For a bus master read/write opetation from a 
16-bit peripheral device operating on an 8-bit bus, 
four control signals must be generated by the 
8/16-bit control unit: address bit 0 (AO), peripheral 
hold (WAIT), bus read (RD), and bus write (WR). 
The AO line is generated by the 8/16-bit control logic 
to indicate which byte is to .be transferred in bus 
master modes only. Otherwise, the AO generated by 
the system is used to indicate which byte is being 
accessed. The WAIT line holds up the peripheral 
during transfers. The RD and WR lines are required 
to indicate successive transfer cycles on the bus. 











Hidden transfers 
. The peripheral’s signals will only strobe active 


once because it does not know that two transfers are |. 


being executed. The slave transfer flows are almost 
identical, except the CPU is generating the bus sig- 
nals and the transfer directions are reversed (ie, a 
bus write goes into the peripheral). 

For this 16- to 8-bit data flow example, the data 
on the upper byte only needs to be latched when data 


In addition to a state flow 
diagram, a timing diagram 
can be used to describe such | 
data read/write operations as 
a master bus read. 
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The 16- to 32-bit conversation logic diagram indicates 
the complexity of bus and funnel logic control. It 
must convert between different signal conventions 
and polarities as well as generate extra functions and 
bus arbitration control signal. 
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is being read (as bus master) or written (as a bus 
slave). An interface to handle this operation needs 
to latch data coming from the 8-bit data bus into 
the peripheral, it also needs to act as transceiver 
when the peripheral is sending data out to the system. 
A device with a clocked, tri-state output that has an 
8-bit wide latch in one direction and a tri-state trans- 
ceiver in the other direction would be ideal for 
accomplishing such an interface. 

The Am2952 8-bit bidirectional I/O port provides 
a good enough match to the logic and allows the 
upper data bus latch and upper data transceiver chips 
to be combined on one IC. It provides two 8-bit 
~clocked I/O ports, each with tri-state output con- 
trols.and individual clocks and latch enables. An 


Am2949 bidirectional bus transceiver completes the. 


logic required for the data path function. 

The state flow control requires logic that can move 
sequentially from state to state, hold in a particular 
state, and be reset or initialized back to a predefined 
state. Depending on the number of states required 
. (generally less than 16 distinct states for a design of 
this complexity), a 3- or 4-bit counter should be able 
to solve the problem nicely. 

Considerable bus control logic is required to gen- 


erate the data path flow logic and the bus control | 


signals. This is especially true if the peripherals and 
CPUs use different signal conventions (eg, when AS, 





DS, and R/W use address latch enable, RD, and | 


WR). conversion from one. signal convention to 
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another, changes in signal polarity, and provision 
for extra functions.(such as generating AQ) require 
a lot of logic synthesis ability. If the peripheral has 
bus master capability, such additional information 
as bus arbitration controls must be fed into the next. 
state determination logic in order to decide what con- 
trol sequence to follow. 


Customized interface minimizes cost 

An 8/16-bit control interface between the Am8052 
CRT controller and an 8-bit CPU provides a good 
example of how customizing a general interface can 
reduce costs. (The CRT controller is designed with 
a 16-bit data interface.) The onboard DMA unit 
fetches data from system memory and the CPU polls 
the CRT-controller’s internal status and control 
Because the CRT controller does not 
modify system memory, however, a bus master write 
operation is unnecessary. Thus, there is no reason 
to generate a system write control signal (WR). 
— In addition, the control and display information - 
must be aligned on word boundaries. This require- 
ment relieves the 8/16-bit control logic from funneling 
the bytes and performing odd/even byte transfers. 
It also saves control inputs from the CRT controller 
because all transfers are words; that is, no: need 
exists for upper and lower data strobes or byte high 
enable inputs. | 

The bus master read operations are standard 16-bit 
data transfers divided into two 8-bit transfers. The 
CPU’s slave accesses are either pointer writes (to 
select the desired control/status register) or 16-bit 
data read/write operations. (Pointer write operations 
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The state machine and the bus and latch controls 
have to be coupled in order to transfer data between 
the 8- and 16-bit buses. This generalized machine is 
designed with the assumption that the peripheral has 
bus master capability. If this is mot the case, the 
- can be greatly simplified. / 
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are actually 8-bit operations because only the lower 
8 bits of the data form the register address.) The bus 
master read operation can be represented by a state 
flow diagram or a timing diagram. Conceptually, 
state flow diagrams are easier to understand, but tim- 
ing diagrams usually convey more information. 
Other state flow diagrams can.be derived directly 
from the timing diagrams of the CRT controller to 
8-bit interface. 


Simplifications allow synthesis on one device 

Two special conditions must be met in the state 
machine implemented in the 8/16 interface. First, 
before a new transfer cycle is attempted (when the 
state machine is waiting in the initial state, SO), 
memory acknowledge (MRDY) must be inactive. 
This prevents interference from the last transfer. 

The second special condition occurs when the 
CRT controller asserts the R/W line to indicate a 
write operation. Although the CRT controller does 
not write data.into system memory, when it updates 
the upper 8 bits of the 24-bit address latch the R/W 
line indicates a write: Operation (in conjunction with 
AS). The CRT controller is not actually performing 
-a system data write, only an address latch update. 
The state machine, therefore, must not start a bus 
sequence if the R/W line is held active ‘low by the 
CRT controller during a bus master operation. 


These simplifications in design allow the CRT con-. 


troller to 8-bit CPU control interface to be synthe- 
sized in a single AMPAL22V10 programmable logic 
array device. In addition, the bus control signals are 


converted from AS, DS, and R/W to RD and WR. 


The minimum CRT controller and bus control sig- 
nals that must be generated are RD, AO, DS, and 
R/W. Although the CRT controller uses DS and 
R/W as inputs during a bus master operation, the 


The jogic for contro} and 
data transfer between an 
Am8052 and 8-bit CPU has 
the control interface 

‘ implemented in an 
AmPAL22V10. 





PAL device must convert the CPU RD and WR sig- 
nals to DS and t/W for:slave I/O operations. 
The signals AO and RD are generated by-the con- . 
trol logic when the CRT controller is performing a 
read access to system. The WAIT (or not READY) 
signal to the CRT controller must also be generated 
by the control logic. The data flow controls require 
six additional controls to load and strobe the latch, 
and to enable transceivers to pass data to and from 
the 8-bit bus. Theoretically, 4 more bits (outputs) 
are required to represent all the control states needed 
to manipulate the 8/16-bit control logic. This means 
the design appears to need 14 output logic units in 
a PAL device to perform the required task. 
Reducing the 14 output cells to the 10 cells avail- 
able in the PAL device requires a closer look at the 
timing and output switching functions. The AO and 
RD control lines are in effect part of the system bus 
control and, therefore, cannot be multiplexed easily. 
The DS and R/W lines to the CRT controller are 





also fixed because they must be valid throughout the 


entire transfer cycle as well. | 

This leaves 6 of the 10 output logic cells of the 
PAL device to represent the remaining 10 identified 
control lines. This method of minimization involves 
careful state synthesis, analysis of the signal switch- 
ing functions during the transfers, and utilization 
of several control pins on the CRT controller. By 
using the BREQ, BACKI, BACKO, CS, and C/D 
inputs to the PAL device, we can reduce the num- 
ber of unique states required to 8 instead of 15. This 
reduces the number of logic cells required for the 
state machine from 4 to 3 bits. 

At this stage, the design requires seven control sig- . 
nals to manipulate the data transfer registers and 
WAIT line. The two latch enables (CEs and CDR) 
on the Am2952 bidirectional I/O port can be © 











AS 





permanently enabled. By controlling the clock signal 
to the latches, the controls required for three pins 
can be reduced to one. The interface control state 
~ machine will only use the correct side of the dual 
latches on the bidirectional I/O port. 

The Am8052 CRT controller helps considerably 
with its own control bus interface. Two signals 
provided by the CRT controller, TBEN and RBEN, 
switch the data transceivers in the correct direction 
regardless of the type of data transfer (as a bus 
master or bus slave). When the controller is a bus 
‘master performing a read operation, or when it is 
a bus slave slave undergoing a write operation, therefore, 
the RBEN signal is strobed to obtain the correct 
polarity. By using this line, two of the. remaining 
six control lines can be eliminated (REN on the 
Am2949 and OEas on the Am2952). Although the 
TBEN line performs:a similar function, it does not 
function correctly in a 16- to 8-bit multiplexed 
bus environment. | 

Two of the remaining control lines (OEas on the 
Am2952 and 10 on the bidirectional bus transceiver) 
must be generated by individual cells in the PAL 
device. The two clock enables on the Am2952 are 
permanently enabled. The two Am2952 clocks are 
tied together to minimize the amount of logic re- 
quired in the PAL device used to generate clock 
strobes to the latches. | 

This leaves the design with three logic cells and 





four output functions (the WAIT line to the CRT 


controller and the 3 state bits). Careful analysis of 





the state flows and timing diagrams indicates that 


the WAIT line is only asserted in 4 of the 8 states. 
A clever. assignment of state numbers to the state - 
flow sequence allows the WAIT line to be absorbed 
into the 3 state encoding bits. The logic equations 
for the AMPAL22V 10 devicercan be derived directly 


from the timing diagrams. 


An unusual problem might occur when a periph- 
eral device operates as a bus slave on a smaller data 
bus, such as a 16-bit peripheral to 8-bit CPU. During 
the first slave write operation, the chip select CS is 
enabled by the bus master making the access. No 
actual data—just.the data latch—is strobed into the 
peripheral, however. After the first byte of data has 


been written, the second access causes the full 16-bit 


data to be strobed into the peripheral. 

If the designer is using a common CS function to 
both the peripheral and the 8/16-bit control logic, 
the controller logic must be designed not to glitch 
or strobe any of the control lines to the peripheral 
(it must prevent DS, R/W from being enabled, for 
example). For some peripheral devices, glitches on 
the control lines might cause the register to be written 
accidentally onto a register that will be overwritten 
in the next write cycle anyway. With other periph- 
erals this might be a catastrophic event. Many 
devices acting as bus slaves have write recovery time 
requirements (ie, a certain minimum interval between 
corisecutive write operations). Glitches on the con- 
trol lines might force the next (and final) write oper- 
ation to be delayed—or cause a violation of the 


The data bus and. control 
interface between an 8-bit 
8088 CPU and a 16-bit 
Am9516 DMA controller uses 


an AmPAL22V10 for 
control, and a 74LS161 for 
state sequencing along with 
a bidirectional I/O port 
and transceiver. 


as 








device specifications. Glitches might evade any spe- 
cial addressing/register accessing scheme used in the 
peripheral. This might occur, for example, if the 
slave device requires the user to write the address 
of the register that was accessed immediately before 
the register was written. In this case, glitches or use- 
less control strobes could wreck the sequence. 
The problem can also be solved by using two lines. 


In this solution, one of the lines would go to the: 


peripheral device and the other would connect to the 
8/16-bit controller. The chip select to the peripheral 
is activated each time a slave read occurs (for both 
upper and lower byte accesses), or-when a slave write 
operation occurs and the unlatched 8-bit data is 
being written. The chip select function to the 8/16-bit 
controller is chosen each time the peripheral is 
selected normally (for slave read/writes on both 
upper and lower 8-bit data transfers). This problem 
is bypassed completely when two separate chip select 
functions are used: one for loading up the Am2952 
latch during a slave write/read and one to strobe the 
Am8052 controller into action when it is needed by 
the 8-bit CPU. 
Bus conversion maximizes flexibility 

A data bus and control interface to an 8088 8-bit 
microprocessor and Am9516 16-bit DMA controller 
can be created using four devices: an AMPAL22V10 
for the control block, a 74LS161 counter for the state 
sequencer, an Am2952 bidirectional I/O port, and 
an Am2949 bidirectional transceiver. 

This design incorporates certain. simplifications. 
The DMA controller requires word accesses only 
during command chaining and for slave register ac- 
cesses. The 8/16-bit data transfer interface for bus 
master operations (ie, DMA data transfer functions) 
- is handled automatically as a programmable option. 
During slave write operations, the first byte output 
to the DMA controller must have an odd address 
and the following second byte an even address. Con- 


versely, during a slave read cycle, the first byte read — 


from the DMA controller must be at an even address 
and the second at the next higher odd address. 
Furthermore, for bus master operations, the sys- 
tem must use the latched address line AO (LAO) from 
the AMPAL22V10 as its sole AO. Because the logic 
is already available, the system does not have to pro- 
vide this function. LAO now becomes the system ad- 
dress bit 0 with full 24-mA drive capability. 
Deciding on a means for controlling the funneling 
of the data stream—that is, transforming 16-bit data 
into 8-bit data and vice versa—was the first step in 


deriving this example. As mentioned earlier, simply — 


_ dividing each 16-bit access into two 8-bit data trans- 
fer cycles presents one way of doing this. On out- 
going accesses (16-bit path from the DMA controller) 
during the first cycle, the upper half of the 16-bit 
path is latched while the lower half passes through 
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BEGIN 
IF (RESET) THEN ARESET( ); 


This section defines the wiggles when the Am9516 is bus master 


IF  (HLDA) THEN ENABLE( ); 
IF  (/S[2} * HLDA) THEN BEGIN 
IF (S[1}] * /S{0}) THEN 

LAO = /CK * BW + /BW * AO * 
ALE + / BW * LAO * /ALE ; 


ELSE 


LAO == BW + /BW * AO * 
ALE + /BW* LAO * /ALE ; 


END; 
‘ 1F = (HLDA) THEN 
(CASE) (S[2:0}) 
BEGIN 
1) BEGIN 
RD. = /RW * DS 


A = /BW * /RW* /CK 
WR = /BW * RW * DS 


C = /BW* RW 

WAIT = 1 
END; 

2) BEGIN 

RD = /RW * DS 

B = BW 


A = /BW * /RW 
WR = /BW * RW * DS 


C = /BW* RW 

WAIT = /BW 
END; 

3) BEGIN 


RD = /RW* DS *B 


B = BW* CK 
A = /BW* RD 


WR = /BW * RW * DS 


C = /BW* RW 
WAIT = BW 
_ END; 
5) BEGIN 
RD = /RW * DS 
A = /BW* /CK 
WAIT = BW 
END; 
6) BEGIN 
RD = /RW * DS 
A =/BW © 
END; 
7) BEGIN 
RD = /RW* DS 
A =/RD 
END; 
END; 


This section defines the wiggels when the 8088 is bus master’ 


BEGIN 


LAO= AO * ALE * SEL + LAO * /ALE * SEL 


B = LAO * WR * SEL 
A = /LAO* WR* SEL 
DS = A + /LAO * RD * SEL 
C= /LAO * RD * SEL 
D = LAO * RD * SEL 
END; 

END. | 


This PLPL file implements an interface between the 





8-bit 8088. and the 16-bit-Am9516. 


Programming the PAL and the counter 


In writing the Programming Language for Program-. 
mable Logic (PLPL) file to control the operation of 
the AmMPAL22V10 and the 74LS161 counter, the 
inputs to the PAL device from the counter are as- 
signed SO, S1, and S2, respectively. Then, it is pos- 
sible to apply a “sculptured design” technique to 
the entire timing diagram (see figure in Panel, “A 
matter of timing”) by using the Case statement from 
PLPL. By assigning combinatorial equations to only 
one binary partition or column at a time (Case), the 
designer can ignore all other aspects of the design 
for the time being and generate simple equations 
directly from the timing waveforms. 

During clock time T1 of the Am9516’s word read 
cycle the state of the 74LS161 (SO, S1, S2) is cleared 
to 000 by the assertion of address latch enable 
(ALE). LAO is the only output control signal from the 
CRT controller asserted during this period. This sig- 
nal is handled as a special case, however. During 

_ time _T2 of the DMA controller's word read cycle, 
the RD and WAIT outputs from the CRT controller 
must be asserted. This time partition corresponds 
to the state inputs S2, $1, SO=001. Therefore, the 
first Case equations are | 


CASE 
BEGIN 
1) BEGIN 
RD = 


(S[2:0}) 


IRW*DS_ ; Transform Control 
; Signals /RW and DS 
; into. Intel /RD 
WAIT = 1: ; Assert Wait 
; unconditionally | 


END; 


During time T2 of the DMA controller’s byte read 
cycle, A is the only additional output not already 


a tri-state buffer onto the 8-bit bus. During the sec- 
ond cycle, the tri-state buffer is turned off and the 
previously latched half of the data is driven onto the 
bus. On incoming accesses (8-bit path to 16-bit path), 
the process is reversed. 

The control mechanisms that perform this cycling 
depend on the WAIT and R/W signals passing to 
and from the DMA controller, and on the ability 
to enable or disable the latches and transceivers selec- 
tively. The Am2952 bidirectional I/O’ port was 
chosen because of its dual registers and its flexible 


‘control. The AmPAL22V10 device was chosen to _ 


match the required number of control pins and func- 
tions. Since the complexity of this design requires 
the use of all of the PAL’s I/O pins for control func- 
tions, however, it was necessary to use a 74LS161 
counter to provide the state sequencer function. 


Programming with PLPL 

It has long been the logic designer’s “art”? to merge 
the often very different concepts and notations of tim- 
ing information with Boolean logic. Yet, the evolu- 


_ Logic,”’ 


accounted for in the Case seianeeis This signal. | 
allows a byte of data to flow through the bidirec- 
tional bus transceiver into the DMA controller’ 
during byte read operations..Some additional con- 
straints are placed on this signal, however: it must 
only be asserted in time T2 on byte read operations. — 
(the B/W input) and it must be delayed by a half . 


clock period from the rising edge of T2 (CK signal). 
_ Thus the Case Statement becomes 


CASE (S[2:0]) 
BEGIN 
1) - BEGIN 
RD= /RW*DS ; 
= /BW*/RW*/CK ; enable the . 
> receiver 


WAIT = 1 
END; 


__ Finally, by examining the last time T2 elements 
(WR and C) during the DMA controller’s byte write 
cycle, the remaining terms in Case 1 are derived. 
With the exception of LAO, the remaining:equations 
were developed in the same fashion. Clearly, this 


' “sculptured” technique is a very. simple and 


methodical means for arriving at the Boolean re- 
quirements for a logic block. 

As the PLPL listing shows, the signal LAO was 
handled slightly differently from the previously dis- 
cussed method. The number of product terms gen- 
erated via the Case statement made this approach 


‘ necessaty. The number exceeded the upper limit 


(16 terms) for a programmable logic array. As a prac- 
tical matter, therefore, it was necessary to optimize |. 
this signal manually. However, it should be noted 
that this step will not be necessary once the fully 
optimized version of PLPL becomes available. 





tion of a syntax to fully express this art has taken . 
a long time. AMD recently developed such a language 
for programming the AmPAL22V10, however. 

‘‘Programming Language for Programmable 
or PLPL, allows the designer to specify a 
design using multiple input formats. This specifica- 
tion flexibility supports the variety of design 
approaches necessary to express different design 
problems efficiently. These formats range from sim- 
ple sum-of-products Boolean equations to high level 
constructs. PLPL also supports the input specifica- 
tions for many types of AND/OR based devices, in- . 
cluding all of the current AMD programmable logic 
array and PROM devices, | 

PLPL is block structured, and includes the high 
level language constructs If-Then-Else, Case, and 
For; all familiar to many programmers of the C and 
Pascal languages. Macros, functions, constants, and - 
variables may also be used in PLPL. The language 
also facilitates use, clarity, and self-documentation. 

Such current programmable logic technology and. 
psseaalen programming languas ces as PLPL allow 
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A matter of timing 


The complex AmPAL22V 10 design used the accom- 
panying timing diagram to correspond to the 
desired waveforms. They are partitioned by the 
_ftespective binary state (or count) from the counter. 
_ The: desired timing requirements during the 
period when the DMA controller is bus master 
appears below. During time T1, address latch 
enable (ALE) is asserted by the DMA controller to 
denote the beginning of the cycle; a short time later, 
an address is driven onto the bus. This address is 
valid at the falling edge of ALE. The control signal 
LAO (latched AO), therefore, must be valid at this 
time, as well. In this phase of the cycle, it must also 
be high to enable the odd byte from memory to be 
loaded into the bidirectional I/O port. In addition, 
the assertion of ALE performs the function of reset- 
ting the 74LS161 counter to 0000 in order to syn- 
chronize the cycle. 
__During time T2, the DMA controller will assert its 
DS signal. The timing for this signal, in conjunction 
with the R/W signal (asserted in T1) must be trans- 


Am9516 
WORD READ CYCLE 
Tf Ty oh TW 
Am9816 : 
CLOCK 


1-1 W—>|<—T WoT W of TW el 


_ formed into an 8088-equivalent RD signal. During 


a word read cycle, this RD signal also must be arti- 

ficially negated and then reasserted to accomplish 
a double byte read. At the same time, the DMA con- 
troller must be “parked”’ in order to multiplex or 
assemble a word. Thus, the WAIT signal is atso 
asserted at time T2. During time TW. (S2, S1, 

SO = 010), the receiver clock enable control signal 
B must be asserted in order to allow the next sys- 

tem clock’s rising edge to strobe the upper byte into 
the bidirectional I/O port. This is accomplished dur- 
ing the next TW period (S2, $1, SO0=011). 

During the remainder of the word read cycle, RD 
is negated and then reasserted after LAO has been 
forced low to address the even byte. A is then 
asserted to allow both the previously latched upper 
byte and the current lower byte to be driven onto 
the DMA controller's pins. And finally, the WAIT sig- 
nal is negated, allowing the DMA controller to finish 
its read cycle by strobing in the 16 bits of command 
data on its data pins. 


Am9516 Am9516 
je-————— BYTE READ CYCLE ——-_—_» BYTE WRITE CYCLE Toa 


fT) >| T2 |= TW >|+-T3 |< 1 = T12 = TW—l<-T3 


; Dg to O15 


Do to O15 Do to Dis 
| Ap to Ais ADDRESS DATA LATCHED , DATA IN ADDRESS DATA IN ADDRESS DATA OUT 
AXX LATCHED Ap XXX 
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highly sipaniied application-oriented control blocks 
to be formed easily. These tools can conceptually 
raise the designer above the details of the design at 
the logic level and directly translate the necessary 
response characteristics from a timing. diagram. 
This approach can be referred to asa “sculptured 
design’”’ technique because it is analogous to the way 
solid stone is formed according to an artist’s image. 
Raw logic can be transformed directly into useful con- 
trol functions from the desired timing information. 


LATCHED Ap 





The AmMPAL22V10 is, in essence, a fuse-program- 
mable gate containing up to 22 inputs.and 10 out- 
puts. It can define and program that architecture of 
each output on a pin by pin basis. Thus, the designer 
is free to optimize the design mix between registered 
and combinatorial functions as needed. | 

The AmPAL22V10 is programmed by opening fus- 
able links in any or all of its 10 output macrocells, 
as well as in its AND gate array. The AND gate struc- 
ture is very similar to other PAL devices; therefore 
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-displayed white on black. Proportional spacing is 
achieved by altering the CLK2 input to the Ams8052. 
The CLK2 spacing can be made to be as narrow as 2 
pixels, or as wide as 17, assigning each character a 
width value that can be used to program the CLK2 
output of the Ams153. Proportionally spaced video 
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Fig 4 A 16-bit character attribute | 
affects each individual character as it is 
output from the CRT controller (a). In— 
memory, however, each new character 
need not invoke a new attribute, In 
example (b), the latch attribute, in 
conjunction with the reverse attribute, 
allows a string of characters tobe 8 
displayed in reverse video without each 
character sade to be ae 
apversed. me 





characters allow the screen to be formatted similar 
to the output of a proportionally spaced printer. 


Thus, proportionally spaced text can be composed 
-accurately on the screen, prior to printing. 


The CLK2 output of the Ams153 can be further 
modified by trailing blanks. Any number of blank | 
pixels, between 0 and 3, can be inserted after the | 
visible character. This allows the user to implement 
a smooth right justification of text, without insert- 
ing blank characters between consecutive words. . 

In addition to handling characters, the controller 


chip applies innovative techniques to the raster 


scan. It provides programmable horizontal syn- 
chronous (HSYNC), vertical synchronous (VSYNC), 
and BLANK signals, and accepts an external syn- 
chronization input. This input allows the frame to 
be synchronized to some external source such as 
line frequency, which prevents annoying in- 
terference display patterns known as “‘swimming.”’ 

Beyond supporting the more common noninter- 
laced and interlaced modes of operation, the chip 
also has a repeat field interlace feature that has. 
each character row effectively repeated and offset 
by the scan line. This has the effect of making a | 


| vertical stroke on the screen look more solid, to 


match the horizontal strokes. 


! 


Reprinted with permission from COMPUTER DESIGN 


At0 | | ae a @ 


APPENDIX. B 


Chip Set Gives A Smooth Scroll In CRT Displays 
-Steven Dines and Mohammad Maniar 


2 
a 





CHIP SET GIVES A 





SMOOTH SCROLL IN 





CRT DISPLAYS 





Two large scale integration chips and a read only memory 
font generator interface 16-bit processors with CRTs directly 
to control scrolling in multiple windows and to space 


characters proportionally. 


by Steven Dines and 
Mohammad Maniar 


Marrying state-of-the-art display technology and - 


computational capability in today’s terminal re- 
quires a large data handling capability. Features 
such as a noninterlace flicker-free frame refresh 
and a full-page graphics representation dictate high 


dot update rates in the 100-MHz range. This speed . 


can only be handled by emitter coupled logic chips 
with all of their attendant problems. Similarly, 
embedded local editing intelligence places severe 
constraints on a terminal’s microprocessor sub- 
system, which must efficiently handle such inter- 
active tasks as insertions and deletions. 


Steven Dines is currently a department manager at 
Advanced Micro Devices Inc, 901 Thompson PI, 
Sunnyvale, CA 94086, where he is responsible for 
microprocessor peripheral product planning. He holds 
a BSEE from the University of Leeds and an MSEE 
from the University of Manchester, England. 


Mohammad Maniar is supervisor of MOS 
microprocessor design engineering at Advanced Micro 
Devices. He holds a Bs in electrical engineering from 
NED Engineering College, Pakistan, and an MSEE 
from the University of California, Berkeley. 
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These and many other obstacles have been solved 
by a 2-chip cathode ray tube (CRT) controller set 
that combines the advantages of N-channel metal 
oxide semiconductor and bipolar technologies. The 
two chips, together with an offchip font generation | 
circuit, form a complete CRT interface between the 
microprocessor bus and the monitor (Fig 1). In this 
application, the Ams8052 CRT controller is used as a 
direct memory access (DMA) controller. This has 
two advantages: first, it eliminates a separate DMA 
controller, thereby keeping costs down and saving 
space in the CRT terminal. Second and more signifi- 


cant, the DMA channel on the CRT controller can be 


customized to facilitate the controller’s editing func- 
tions. Thus, a font-control read only memory allows 
a full video subsystem to be built that matches 


display data formats with printed information. 
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The DMA channel is configured as a linked-list 


processor, which sets up the display data with 


minimal editing overhead. This channel fetches 
data into onboard buffers that store three rows of 
character information. Incorporating triple row. 
buffers onchip solves a major impediment to a 
pleasant-looking display: it allows the user to scroll 
smoothly in a split-screen application, which has 
_always been a major problem in screen formatting. 

Parallel pixel data emerge from the font gen- 
erator.and are serialized by the CRT controller set’s 
second chip, the Ams8153. All clocks for the system 
are also generated here. These consist. of a 
100-MHz pixel or dot clock, and two subclocks, 
the Ams052 CLK1 bus clock and CLK2 character 
clock. Emitter coupled logic (ECL) outputs in the 
Am8153 obviate the need for peripheral ECL output 
devices. Thus, both analog and ECL video are out- 
put from the Am8153. 


Smooth scrolling 

Scroll has always been one of the main require- 
ments of any display terminal. Usually data are 
moved on the screen on a character row by character 
row basis, which makes for poor viewing. In addi- 
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tion, using ‘“‘hard”’ scroll to rapidly scan a document 
is prohibitive to use because the eye has a hard time 
following the staccato movement of the text. 

Smooth scrolling allows the text to be: scrolled 
gradually, scan line by scan line. Not only is this 
much more pleasing to the eye, but it also allows 
documents to be visually scanned very rapidly, ina 
manner similar to the'way one scans a phone book ~ 
for a particular entry. Implementing this scan line 
by scan line offset is fairly easy. The difficulty lies 
in holding part of the screen stationary while scroll- . 
ing the remainder. The Am8052 supports both split 
screens (horizontal and vertical) and smooth scroll 
of a subscreen—a combination that has previously 
been impossible to implement economically. Win- 
dow screens also create data structure problems 
since each scroll involves juggling large amounts of 
data. While this may be a difficult task for a local 
central processing unit (CPU), the Am8052 CRT con- 
troller integrated circuit (IC) fetches all its refresh 
data by means of a linked-list data structure. 

In this structure, a top-of-page register contains 
the 24-bit memory address of. the first component 
in the list, called the main definition block (MDB). 
The MDB, in turn, points to a sequence of row . 
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Fig 1 Two large scale integration chips and a font-generation read only memory form the interface between a 16-bit 
microprocessor bus and the CRT. Using three row buffers instead of the usual two ensures smooth scrolling in a split-screen 
application. The DMA channel fetches rows of characters into the three row buffers and outputs multiplexed data for 
attribute and cursor generation. The video processor chip serializes data for a video cutput and synchronizes the display 
with all'the appropriate timing signals. The font generator can format the characters for proportional spacing.to match the. 


typical proportionally spaced characters of a printer output. 
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Fig 2 Windowing requires manipulation of a large amount 
of data. By using a linked-list data structure, the CRT 
controller chip can perform the windowing task at the CRT 
refresh rate. The chip maintains parallel control over the 
characters for both the full screen and the window. In this 
example, the three row control blocks keep track of their 
row entries in the background of the Screen, while at the 
same time the window control block is used to insert the 
word “Cow” in the appropriate window. 


control blocks (RCBs). These blocks hold pointers to 


character and attribute lists for the appropriate 
row. The controller IC scans this complete list once 
per frame. Furthermore, the Am8052 keeps an eye 
on a second parallel list—the window data struc- 
ture. This window linked list is used to overlay win- 
dows onto the screen. As the controller fetches 
screen data, it jumps from the screen to the win- 
dow and vice versa to format the display (Fig 2). 

After setting the display and one or more win- 
dows, the user can now issue a’ ‘scroll window”’ 
command to set the scroll in motion. When scroll- 
ing the screen, the user must ensure that the data 
structure js updated fo reflect the new screen by 
modifying a pointer. Likewise, when scrolling one 
of multiple windows, the user must then update the 
window list in a similar fashion. In both cases, no 
complex data movements need occur. The Am8052 
can scroll as slowly as one scan line every eight 
frames, and as fast as eight scan lines per frame—a 
significant spread in scroll rates. A system of in- 
terlocks protects the data from corruption during 
this scrolling. 


A split-screen smooth scroll mandates three row © 


_ buffers; a 2-row buffer configuration [Fig 3(a)] is 
acceptable for a single screen. Each of the rows is 
swapped or toggled with the other. Thus, while one 
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row is being loaded, the other can be displayed. As 
long as each row buffer (ie, character row) is 
displayed for multiple scan lines, enough time is 
available to reload. However, for a ‘split-screen 
smooth scroll, a character row can only be present 
in the frame for one scan line. This does not permit 
the alternate row buffer to be loaded and causes 
the screen to flicker. With three row buffers, 
however [Fig 3(b)], the problems of single scan line 
rows are averaged out, eliminating annoying screen 
flicker. a | 


Character display generation 

The Am8052 gives a flexible character capability 
to a video display terminal. Once the size (in scan 
lines) of a given character row is determined, the 
characters can then be placed in any position on the 
row. Further, row size can be varied on a row-by- . 
row basis, and characters can be displayed as 
normal, superscripted, or subscripted; to allow 
flexible text. . 

Each character can be modified by an attribute 


_word [Fig 4(a)] that is stored along with the 


character in the row buffers. Attribute words are 
fetched from memory, at the time the display is on, 
in a fashion similar to characters. The number of 
attributes fetched, however, can be programmed to 
be much smaller than the number of characters, 
thus reducing bus overhead. As in Fig 4(b), the 
string ‘“‘CHANGED” is to be displayed in reverse 
video. By fetching a reverse attribute on the first 
‘‘c”’ and a nonreverse attribute on the first ‘‘N’’ of 
‘“‘NORMAL,”’ only two attributes are required to 
reverse the 7-character string. 

The Ams8052 attribute word on APO-AP10 can be 
used by the Am8153 to produce gray-level video 
from the font generator. For example, normal 
characters are displayed gray on white. If the 
highlight bit is set, however, the character will be 
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Fig 3. For split-screen scrolling applications, a character 
row could be displayed for only a single scan line. With two 
row buffers (a), this does not leave enough time for the 
reloading of the alternate row buffer, which results in a 
flashing screen. With three row buffers operating in a 
rotating fill-display mode (b), any single row buffer can be 
displayed for one séan line without any danger of screen 
flashing. 
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it allows the same powerful, yet familiar features. 
However, it is the AmMPAL22V10’s 10 output logic 
macrocells that give the designer substantial new 
design freedom. Moreover, at each macrocell out- 
put is a tri-state output buffer controlled by a 
separate output-enable AND gate. 

These macrocells provide the AMPAL22V10’s key 
features. They can be configured:to make any or all 
of the I/O pins act either in sequence or in combi- 
nation and have either active-high or active-low char- 
acteristics. Furthermore, the output enables can 
individually control the direction of the pins so they 
act as Outputs, inputs, or bidirectional ports. 

A number of trade-offs and limitations are appar- 
ent in a design that so dramatically affects the input 
and output of the system. The most obvious limita- 
tion stems from under utilization of 16-bit periph- 
erals on an 8-bit bus—the speed of all I/O operations 
are-cut in half. As a result, bus utilization will 
increase if the 16-bit peripheral represents a signifi- 
cant factor of the bus use. A CRT controller such 
as the Am8052 might use 5 to 10 percent of the bus 
bandwidth for display information when using 16-bit 
I/O. Converting to 8-bit I/O would double bus use 
to 10 to 20 percent. Another factor that might affect 


the bus usage is the efficiency of the 8- to 16-bit con-- 


' version control logic. If the state machine designed | 


to perform the 8/16-bit (or 16/32-bit) conversion is 
improperly designed, extra transfer overhead might 
be introduced. This might mean a sequential transfer 
of two 8-bit values would take twice as long a single 
16-bit transfer. a : 
, The design constraints might limit the use of the 


_ peripheral to byte-only operations during data trans- | 


fers (as in the design using the DMA Am9516 con- 
troller), and slow it down by a factor of two during 
command operations. For such a DMA device as the 
Am95l6, the extra time required for command fetch- 
ing is not usually a significant portion of bus time. 
System designers will have to weigh the cost of 
the extra overhead on a case-by-case basis. The ben- 
fits may well justify these limitations—particularly 
when the bus is self-limiting, but the device charac- 


. teristics allow for value-added designs. In addition 


to bus degradation for certain configurations, extra 
logic and design effort are involved. Most interfaces 
outside a system’s immediate family require some 
kind of extra interface logic, however. By manipulat- 
ing the signals and incorporating them into program- 
mable logic devices such as the AmPAL22V10 device, 
therefore, most of this logic is free. 


APPENDIX C 


CRT Controllers Can Enhance Test Display And Simplif 
- Juergen Stelbrink 





” 


aoa 





rs 


oo 


4 


Computer Technology Review 


Winter 1983 





CRT Controllers Can 
Enhance Text Display 
And Simplify Editing 





For screen editing the CPU normally has to move blocks of display data. This time- 
consuming task can be speeded up by use of a CRT controller. 





by Juergen Stelbrink, 
Advanced Micro Devices Inc. 


Reprinted by permission of the publisher from the Winter 1983 
edition of COMPUTER TECHNOLOGY REVIEW 





s termi- 
nals become increasingly sophisticat- 
ed, the designer is faced with many 
new problems in the areas of data ma- 
nipulation and display. The high- 
resolution screen necessary to display 
a full-size 8’ X 11-in. page results in 
pixel rates exceeding 50 MHz. Addi- 
tionally, the use of microprocessor 
technology in modern terminal de- 
signs has transferred the editing tasks 
from the host system to the terminal 
itself. Support for the latest text- 
display features available from letter- 
quality printers can be provided by 
CRT controllers. 

Today’s printers can support 
such text-display features as propor- 
tional spacing with block justification 
and double print. To adapt the 


-word-processing task more fully to 


the human operator, workstations for 
word processing should be able to dis- 
play edited text that looks like the 


printout of these letter-quality 


printers. 

For example, instead of display- 
ing the beginning and end of an un- 
derline with a special character se- 
quence, the workstation should under- 
line the string just as the printer 
does. Additionally, it should support 
features like highlighting (which is 
equivalent to double print in the case 
of a printer), character blinking, and 
multiple cursors to emphasize parts 
of the text. 

Vertical smooth scroll will be- 


_ come a standard feature of future de- 
signs. Also helpful would be windows ° 


(overlaid on the displayed page) to 


provide temporary information about 
issued commands. 


LINKED-LIST DATA STRUCTURE 


In standard CRT subsystems, display 
data is organized as contiguous mem- 
ory blocks associated with video 
frames and stored in video-refresh 
memory. To execute editing tasks like 
character or line insertion or dele- 
tion, the CPU has to move blocks of 
this data—a time-constiming opera- 
tion that slows down the editing 
process. 

Text editing would be faster and 
more elegant if a linked-list data struc- 
ture were used. In a linked-list struc- 
ture, display data is organized in 
small strings—usually rows—held to-. 
gether by pointers. The advantage be- 
comes obvious when you consider ex- 
ecution speed: you can insert or de- 
lete a line by modifying one pointer in- 
stead of moving half the screen down 
(Fig 1). And you can swap pages sim- 


ply by altering a pointer. 


A second advantage is that when ~ 
the display data is stored in the main 
system memory, the CRT controller 
can fetch the data directly from the 
list on which the word processor is op- 
erating, and there’s no need to set up 
a special list of display data. 


WINDOWS 


Windows are text blocks overlaid in 
the background. Usually they're used 
to display temporary information. A 
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Fig 1 In a linked-list structure, data is organized in small strings held together by pointers. A line 
can be inserted or deleted by modification of a single pointer. 


word processor, for example, might 
use the windows to display com- 
mand tables while the background 
still shows the edited text. After the 
user has chosen a command from the 
table, the window is removed to make 
the overlaid text visible again. 
Multitasking systems might use a 
window for each task currently ac- 
tive. In order to keep the window- 


processing overhead small, the data - 


structure of the window shouldbe sim- 
ilar to the background data structure 
so that you can display or remove win- 
dows without modifying the back- 
ground data structure. 


SOFT SCROLLING AND ATTRIBUTES 


Vertical soft scrolling is the gradual re- 
placement of a character row on a 
scan-line by scan-line basis. The dis- 
played effect is more eye-pleasing 
than hard scrolling (where entire 
rows are replaced) and will become a 
key feature in future terminal de- 
signs. The smooth scroll of the entire 
screen is a relatively easy task and 
can be accomplished with a mini- 
mum of hardware. 
However, soft scrolling bf an 
overlaid window or soft scrolling of 
the background while windows are 
displayed is a much more sophisticat- 
ed task. If a window is smooth- 
scrolled, text seems to appear and dis- 


appear within it while the back- 
ground remains stable. If, on the 
other hand, the background is 
scrolled, background text will appear 
to pass under the window. 

There are three kinds of attrib- 
utes, distinguished by the number of 
characters they correspond to: 
® Screen attributes affect the 

text display of the entire screen 

and represent screen informa- 
tion that might vary from page to 
page. Smooth-scroll rate, cursor 
blink rate, and cursor layout are 
all attributes of this kind. 

® Row attributes modify text ona 
row basis. The height of a row 
and the positioning of normal, 
subscripted, and superscripted 
characters are some examples. 

e@ Character attributes modify 
certain characters or strings. Ex- 
amples are highlight, underline, 
blinking, subscript, and super- 

_ script. 

Many CBT controllers treat char- 
acters and attributes in the same fash- 
ion. They fetch one attribute word 
per character. To minimize the bus oc- 
cupancy of the CRT controller, the 
number of attribute fetches should be 
minimized. A fundamental difference 
between the changing rate of charac- 
ters and attributes is that characters 





Fig 2 In proportional spacing, letters vary in 
the amount of line space they occupy. An “M”, 
for example, is wider than an “I”. 


Ce 


are typically uncorrelated along a 
character string and attributes are 
highly correlated, since features like 
reverse video affect a character string 
rather than individual characters. For 
this reason, a flexible correspon- . 
dence between characters and attrib- 
utes saves memory space and re- 
duces the bus occupancy. 

In a demand-attribute mode, an 
attribute is only loaded when the at- 
tribute characteristics need to be 
changed. A flag is positioned in the 
character string to make the CRT con- 
troller fetch a new attribute word, 


which could apply either to the next 
character or to all following charac- 
ters. This flag could be a specific char- 
acter that is not displayed on the 
screen, or it could be any bit of the 
character code. The first option 
would allow a 255-character set with 
a small bus overhead when attributes 
are fetched. The second option 
would halve the character set but elim- 
inates overhead for attribute incor- 
poration. 





PROPORTIONAL SPACING AND 


. CURSOR 


Proportional spacing is now a stan- 
dard feature of high-performance let- 
ter-quality printers. The CRT system 
should be able to support propor- 
tional spacing in order to display a 
text on the screen similar to the print- 
ed text on paper. 

Proportional spacing means that 
narrow characters like “I” use less 
space in a character row than wider 
characters like “M” (Fig 2). The screen 
is no longer divided into a raster of 
character fields. The number of char- 
acters that can be put into one line is 
now a function of the characters 
themselves. Right justification in pro- 
portional-spacing applications re- 
quires a user-definable number of 
blank pixels to follow each character 
so that the text will have a straight © 
right-hand edge. 

Two kinds of cursors are imagin- 


able. A cursor could’ be programmed 


to appear on an X-Y coordinate. This 
type of cursor would be tied to the 
screen. When scrolling, the cursor 
still appears on the same location but 
applies to a new character. The sec- 
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Fig 3 A cathode-ray tube controller (CRTC) uses three line buffers for smooth scrolling of win- 
dows and provides the character code and scan-line address for the character-font generator. 


‘ ond way to specify cursors is to use 
the attribute word. In this case, the 
cursor would be fixed to a character, 
so any scrolling of the screen would 
move the cursor and character both. A 
system usually has only one X-Y cur- 
sor, since edch X-Y cursor needs a © 
~ pair of coordinates. There is no restric- 
tion in the number of attribute cur-: 
sors because this information is a 
part of the attribute word. 

The cursor layout should be very 
flexible. Examples of cursor styles are: 
® Static or blinking underline. 

@ Blinking by switching between 
normal display and blank. 

@ = Blinking by switching between 
normal display and reverse. 

@ Reverse character. 
The X-Y cursor and the. attribute 












CHARACTER (9) 


ATTRIBUTES (5) 


CLK1 DIVIDE RATIO 


CHARACTER WIDTH 


EXTERNAL 
DOT CLOCK 


cursor can have different styles to dis- 
tinguish them. For example, the X-Y 
cursor could be a blinking underline 
and the attribute cursor could re- 
verse the character. 


SILICON IMPLEMENTATION 


-These features are all supported by 


the Am8052 and Am8152/53 CRT con- 
troller (CRTC) chip set. To make edit- 
ing tasks simpler and faster, the set 

supports a display data structure or- 
ganized as alinked list in system mem- 


‘ory. By adding an external character- 


font generator to these chips, you can 
build a complete subsystem that talks 
to the system bus on one side and gen- 
erates a high-speed analog or digital 


DIGITAL ( 


CLK1 (SYSTEM) 


CLK2 (CHARACTER) 


Fig 4 A parallel-to-serial video-shift register generates a high-speed pixel stream from data sup- 


plied by the character generator and the CRTC. 
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video signal on the other. Other fea- 
tures, such.as horizontal soft scroll 
and a loadable character-font genera- 
tor, can be implemented by the addi- 
tion of a few more medium-scale inte- 
gration (MSI) devices and ‘support 
software. 

The first element of this design, 
the CRT controller (Am 8052, CRTC) 
(Fig 3), fetches the display data via the 
built-in DMA controller, interprets 
the linked list, and handles attrib- 
utes, windows, and soft scrolling. It 
has three line buffers to support 
flicker-free smooth scrolling of win- 
dows and provides the character 
code and scan-line address for the 
character-font generator. Its maxi- 
mum character-output rate is 14 MHz. 

The second element in the chip 
set, the Video System Controller 
(VSC), is basically a parallel-to-serial 
video-shift register (Fig 4). It accepts 
the character font from the character 
generator, and the attribute words 
supplied by the CRTC, and generates 


. a high-speed pixel stream. The video 


output provides a 4-level analog sig- 
nal that can directly drive a 752) load 


or a 2-bit digital signal: The video sys- 


tem controller (VSC) can handle video 
rates of 40 MHz (TTL outputs) or 100: 
MHz (ECL outputs), allowing high- 
resolution flicker-free displays. 

The CRTC handles the linked-list 
management,, the windows, soft 
scrolling, cursor, and attribute proc- 
essing. The display data is stored in 
system memory to be easily accessi- 
ble by the host CPU during its execu- 
tion of display-editing tasks. The dis- 
play data consists of characters and 
their attributes, both of which are | 
grouped into segments. One or more 
segments are tied together by a list of 
pointers—the-row-control block—to 
form a row. Row-control blocks are 
connected via a linked list, each block 
pointing to its successor. The CRTC in- 
terprets the linked list and transfers 
the character strings and attributes se-- 
quentially to the character generator. 

The terminal processor loads the 
top-of-page register (Fig 5) to notify 


the CRT controller of the beginning of 


the linked list. The main definition 
block at the beginning of the linked 
list contains screen attributes like 
cursor style and cursor blink rate, | 
and a pointer to the first row-control 
block. The row-control block holds in- 
formation relevant to one row dis- 
played on the screen. It contains 
pointers to the succeeding row- 
control block and pointers to seg- 


_ ments containing character and attrib- 


‘ f 
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ROW 0 CHAR SEG 1 


CHAR SEG N 
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Fig 5 The top-of-page register points to the be- 
gin of the linked list. The main definition block 
contains screen attributes and the row-control 
block holds information for one row of the 
display. 


ute strings. Positioning of subscript, 
superscript, and normal characters 
in the row and the number of scan 
lines per row is optionally redefin- 

able on a row-by-row basis. 

The display data structure repre- 
senting the layout of windows is simi- 
lar to the data structure of the back- 
ground. Vertical soft scrolling | 
of the background or of windows re- 


quires little interaction with the CPU. — 


_The CRTC only interrupts the CPU 

when a row is totally scrolled in or | 
out, to make it relink the data struc- 
ture. The scroll rate is programmable 
and can range from one scan line per 





eight frames (low-speed scroll) to 
eight scan lines per frame (high- 
speed scroll). , 


ATTRIBUTE PROCESSING i. 
ae eee ener 
The CRTC allows flexible attribute 
processing. Attributes are handled in» 
16-bit quantities and fetched on de- 
mand, in order to reduce bus occupa- 
tion for direct memory access (DMA). 
Seven attribute bits are predefined 
and four are user-definable. However, 
the internal attribute processing can 
be partially or totally deactivated to 
satisfy specific application require- 
ments so that the designer can inter- 
face external attribute-processing log- 
ic. The predefined attributes are: 

@ Highlight. Characters are made 
brighter. - 

@ Reverse. The colors of the back- 
ground and the foreground are 
exchanged. 

® Superscript. The character is 
shifted up a defined number of 
scan lines. ro . 

@ Subscript. The character is shift- 
ed down a defined number of 
scan lines. 

@ Underline. The character is un- 
derlined; the position of the un- 
derline is programmable. 

@ = Strike through (shifted under- 
line). The affected character is 
struck through. 

@ = Blink. The affected character 
blinks at a programmable rate 
and duty cycle. 

The attributes mentioned above 


7 SYSBUS 


control an attribute port of the CRTC. 
A special character-font generator 
can be used to display smaller sub- 
script or superscript characters. Two 
attributes are used for internal proc- 
essing only. They are: 

@ Ignore. The character is not load- 
ed into the line buffer and, conse- 
quently, not displayed, You can 
erase a character by setting 

this attribute bit. 

Latched. This attribute word is 
latched by the CRTC and there- 
fore applies to a character string. 
The VSC serializes the character 
stream, processes the attributes, han- 
dles proportional spacing, and gener- 
ates the system timing. In propor- 
tional-spacing applications, the char- 
acter generator consists of two parts: 
one part stores the font of the charac- 
ters; the other holds the character 
width—a 4-bit value. The character 
width is passed to the VSC to deter- 
mine the divide factor for the charac- 


~ ter clock, which is connected to the 


CRTC to specify the character-output 
rate. In addition, the VSC has logic to 


-allow you to justify text by the inser 


tion of up to three blank pixels be- 
tween characters. This technique al- 
lows smooth, virtually unnoticeable 


jine stretching. 


The CRTC can easily be interfaced to 
16-bit system buses. In. slave mode, 
the CPU initializes the CRTC by pro- 
gramming the registers for the timing 
parameters. After the CRTC is activat- . 
ed, it tries to gain mastery of the bus 
to fill the line buffers, and then starts 
displaying. The CRTC bus-interface 


. ) ANALOG 


) DIGITAL 





Fig 6 In a standard proportional-character application, the CRTC’s 8-bit character-code (CCy 
through CC,) and the 5-bit scan-line count (Ry through R,) address the character-font generator. 
The VSC can serialize character slices up to 17 bits wide. 


C-4 
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architecture supports 24-bit linear ad- 
dress buses (68000, 8086) arid 23-bit 
segmented address buses (Z8000). To 
make sure that the system still can re- 
spond to interrupts in real time, the 
CRTC has a burst-length register that 
controls the maximum length of a 
DMA block read and a burst-space reg- 
ister to have a minimum delay be- 
tween two DMA cycles. 

Fig 6 shows a standard propor- 
tional-character application: employ- 
ing the CRTC, the VSC, and a charac- 
ter-font generator. The 8-bit character 
eode, usually ASCII code, allows a set 
of up to 256 characters. The 5-bit scan- 
line address can distinguish 32 scan 
lines. The VSC can serialize up to 17- 
bit-wide character slices, so that the 
maximum achievable character box is 
17 X 32 pixels. 

Since the CRTC fetches all the 
data needed for the display refresh 
from system memory, the controller 


Implementation of Horizontal Soft Scroll | 
The basic idea behind this implementation is to place in 
the front of the line a dummy character that’s rendered 
invisible by external logic that delays the horizontal 


BLANK. You move the entire line by using the VSC’s pro- 
portional-spacing capability to modify the width of this 


dummy character. 


uses a significant part of the bus band- 
width. For each frame, it fetches the 
control, character, and attribute 
blocks. The bus overhead caused by 
the video refresh is a function of the 
number of displayed char acters and 
invoked attributes. 

In systems where the CPU is in- 
volved in editing tasks, it might be in- 
tolerable for the CRTC to use a major 
part of the bus bandwidth. This prob- 
lem can be solved by utilizing a dual 
bus system. The main memory where 
the display data is stored has two 
ports. One is connected to the main 
system bus; the other passes the 
data via a local bus to the CRT 
controller. 

In this configuration, the CRT 
DMA transfer doesn't slow the system 
down. Instead, an arbitration logic 
controls system and CRT access to 
the display memory. The data path 
from the main bus to the local bus is 


NORMAL BLANK 


STEP 1 
STEP 2 
STEP 3 


STEP 4 
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used to access the CRITIC directly to 
alter register contents. 

The structure of the CRTC allows 
you to add special features that.aren't 
directly supported. The implementa- 
tion of horizontal soft scroll is a good 
example of the flexibility of the con- 
troller’s design (see Box). Horizontal 
scroll moves the entire page left or 
right in order to display characters 
that are hidden because the text row 
is wider than the row that can be dis-_ 
played on the screen. Similar to verti- 
cal soft scroll, horizontal soft scroll 


_ moves text on a pixel basis rather 


than on a character basis, so the 
viewer notices very smooth move- 
ments. 


Juergen Stelbrink, applications 
engineer for Advanced Micro 

Devices, has his MS degree incom-  « 
puter engineering from the RWTH 
Aachen, West Germany. 


DELAYED BLANK aa 


é 


When the dummy character is programmed forfull  - 


width, the delayed BLANK covers it. When you reduce 

the width of this character, the first visible character 

moves left and gets partially covered. Characters seem to 
enter the screen on the right side and seem to leave it on 
the left. 

The detailed description that follows assumes a 
nonproportional-spacing application, a character width 
of 8 pixels, and a dummy character width of 10 pixels. 
There is no restriction on these values, but reference to a 
specific environment makes the description easier. 

By reducing the width of the dummy character 
from 10 to 3 (steps 1 through 7 in Fig 1) and a modifica- 
tion of the character-segment pointer in the row-control 
block (step 8), the left-most character is moved out. Each 
scroll step the CPU modifies the width of the dummy 
character one pixel. Decreasing the width causes a left 
scroll; increasing the width causes a right scroll. The 
horizontal soft-scroll speed can be similar to the vertical 
soft-scroll speed (scrolling one pixel per 8 frames to 8 
pixels per frame). It is supported by the CRTC interrupt 
on a vertical event issued once per frame. 

The width of the dummy character is controlled by 
providing an appropriate value at the character-clock di- 
vider inputs of the VSC. This value can be supplied in sev- 
eral ways: 

@ The width can be controlled by the four user- 
definable attribute bits of the attribute word corre- 
sponding to the dummy character. 

Bits of the row-attribute word can determine the 
width. This attribute word is put out during horizon- 
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Fig 1 In horizontal soft-scroll, the proportional-character capability is 
used to reduce the width of an invisible dummy character placed at 
the front of each line. As the width changes, the first visible character 


STEP 5 


STEP 6 
STEP 7 
STEP 8 
STEP 9 


STEP 19 


‘moves left and gets partially covered. 


tal retrace and can be latched by HSYNC. \ 

In proportional-spacing applications, the charac- 

ter-font generator can be programmed to contain a 

set of characters with widths from 3 to 10. 

The second task the designer is confronted with is 
to find a simple solution to delay BLANK. If the system- 
clock cycle is wider than the character-clock cycle, 
BLANK can be delayed by being fed through two D- 


flipflops clocked by the system clock (CLK1) (Fig 2). 


Another approach is to use a counter to delay 
BLANK the appropriate number of pixels. The counter is 
clocked by the dot clock and enabled by the first abs of 
CLK1 or CLK2 after BLANK inactive. 
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APPENDIX D 


Source Code For The Low-Cost Smart Terminal Board 


"8051" 
TITLE " —- CALEB 0.00 ‘Interrupt Handlers" 
FEFEEEEEEEEEEEEEEEEEEEEEEEEEE EEL EL EEE EEE EREEE EEE EERE EEEEEEFEEEE EEE EEEEEEEE EES - ORG O0000KH — : Reset entrypoint 


C_Base ; CALEB 0.00 The 8751 reset condition begins execution here. This entrypoint will only 


a 


I 

mS ; . be entered once, immediately after power is suppl ied to the board. 
; _ Copyright 1985 Advanced Micro Devices, Inc. ; Go to the reset procedure 
; 


This file contains the reset and interrupt entrypoints as well as the 
interrupt handlers. Oe | . 
. ORG ~ 00003H ; External interrupt 0 entrypoint 
NAME “Interrupt Handlers" 
The external interrupt 0 entrypoint is defined below. The 8751's INTO* 
input is connected to the Am8052's bus request (BRQ*) output. Therefore, 
this interrupt occurs when the Am8052 desires control of the display 
memory bus for performing video refresh. . | 


me =e =e =a 


PUSH P2 Save port 2 contents and keep 
MOV P2,#0FFH it from interfering w/Am8052 
7 in C_Init LUMP BusReqHdl Go to actual’ handler 


in C_Util 
in C_Util 
in C_Util ORG OO00BH | :; Timer 0 interrupt entrypoint 
in C_Util 


PlcCsr, ShwWnd 
EXT ScrlRtOne, SerlLtOne, SetForScrlUp, SetForScrlDn 
EXT SetAftScrlDn, SetWndPos. 
_ EXT = WrAm8052Reg,RdAm8052Reg | 


=s =e Ss BO 


The timer 0 interrupt entrypoint is defined below. The 8751's TO input 

is connected to the Am8052's BLANK output. This has the affect of counting 
visible scan lines. The counter is reloaded during vertical retrace so 
that the interrupt occurs twenty-eight (28) scan Lines before the vertical — 
blanking period begins at the bottom of the monitor screen. 


SEEEEEELEEEEEEEEEEL ELE ET EEE EEE EEE EEE EEE EEE TEESE EEE EEE T TET E ETT ttt ttt ttt ttt ttt 


SKIP 
INCLUDE C_MemMap 


=e =a =e =e =e 


SKIP 
SEEEEEEEEL TEESE ETE E EEE EEE EEE TEE EEE ETE E EEE EEE EEE EE EEE EE EEE EEE EE EEE E TEE E EEE ttt PUSH PSW 


SETB RSO 
This is the base of the Am8052/8152 Low Cost Terminal demonstration firmware. SETB RS1 
The entrypoints for the reset and five interrupt sources are defined here. . EndFrmidl 
There are only eight bytes between interrupt entrypoints, so when a larger 
handler than that is required the entrypoint must transfer control elsewhere. 
‘This .is the case for most of the interrupt handlers we have implemented. 


f 


Save normal flags 

Change register bank for 
high priority interrupt 

Go to actual handler (which 
must be in first 2K of code) 


=e =s “28 Sse We 


e 
e 
e 
a 
« 
a 
. 
a 
a 
a 





_t-a 


=. =. me me 


* ORG 00013H 


. 
f 
e 
a 
e 
7 
. 
f 
. 
ti 


=. =e =e 68 me 


4 External interrupt 1 entrypoint 


The external interrupt 1 entrypoint is defined below. The 8751's INT1* 
input is connected to the Am8052's INT* output. This interrupt occurs 
for the vertical event or when the soft-scroll (smooth scroll) process 


in the Am8052 requires attention. 


Save normal flags 

Change register bank for 
high priority interrupt 

Go to actual handler (which 
must be in first 2K of code) 


PUSH PSW 

SETB RSO 

SETB. RST 
Am8052Hdt 


ORG 0001BH 3; Timer 1 interrupt entrypoint 


Timer 1 is used to provide the clock for serial communications with the 
host; therefore, the timer 1 interrupt is disabled and this entrypoint 
should never be executed. As a precaution, we put a jump-to-self here 
for use while debugging. We also included other code, as if this were 
a valid interrupt, so that it would be possible to continue. 


; Save normal flags 
Stick right here 
Restore normal flags 
Exit from interrupt. 


PUSH PSW 
LuMP $ 
POP PSW 


ORG 00023H . ; Serial port interrupt entrypoint 
The serial port interrupt entrypoint is defined below. The 8751's serial 
port capability is used for communications with the host. Currently, only 
reception is implemented since CALEB does not generate output. The addition 
of ANSI X3.64 report capabilities or the inclusion of a keyboard will make 


transmi ss ion necessa ry. 


PUSH PSW Save normal flags 


Go to actual handler (which 


AJMP HstComHdl 
must be in first 2K of code) 


ww 


SETB RSO .~ Reg bank for low priority intr 
‘ 


‘ 
t 
™6 me =e =s = 


as 


TEEEEEEEELELEEEAE EEE ESE EEE EEE EEE EE EE EE EEE EEE EEE EEE EEEE TERETE EE EEEE EEE EEE EEE ET 


SKIP 
TEEELEEELEL EET ERSTE EEE EEE EE EEE EEE EEE EE ETEEEEE EEE EE EEE EEE EEE EEE EE EEE EEE EEE EEE 


; Begin relocatable program here — 


CopyrightMsg: 


DB a Copyright 1985 Pee Micro Devices, Inc. " 
peeeeeCeeCLeceetescest tess Teves tse t@avertesttsd test re eet tet teeteetwetwed 


BusReqHdl : 


Handles the bus request interrupt from the Am8052. The bus acknowledge 
signal_is output until the Am8052 no longer desires the bus then it is 
returned to its inactive state. The contents of port 2 are saved and 
restored so that the port can be configured as all inputs during Am8052 
bus transactions (any pins configured as outputs will interfere with the 
Signals on the bus). Port 2 reconfiguration has already been done by 
this time. . 


me me =e ma =. ms ms 


Acknowledge the bus request . 
Stay here 'til BRQ* is released | 
SETB Am8052BusAckFlg then remove bus acknowledge 
POP . P2 Restore port 2 contents 

RETI | : - Exit from interrupt 


‘CLR Am8052BusAckFlg 
JNB Am8052BusReqFlg,$ 


EPEEEEEEE EEE EEE EEE EE EE EEE EEE EEE EEE EEE E EE EEE EE EEE EEE EEE EERE EE EE EEE EE EEE EEE EEE 
SKIP 
TERETE EF EEEEEEEE EEE EEE EEE EE EEE ET EEEE EEE EE EEE EEE EEE FEEL EEE EE EEE EEE EE EEE TET 


EndFrmddl: 


Handles the timer 0 interrupt which occurs near the end of the frame (at 
the 28th visible scan Line from the bottom of the monitor screen). It 
sets a flag (which is reset by the Am8052 interrupt handler) to signal 
the start of this end-of-frame processing time. This handler also does 
all changes to display memory to support horizontal smooth scrolling. 





EndFrmF lg 
HrzScrtFlg,EFHO 
HrzFrmCnt ,EFHO 

ACC ; 

DPH 

DPL 
HrzFrmCnt,HrzFrmSet 
AMDDWMBit, EFH1 

RO, #6 | 

EFH2 


RO, #9 


HrzDirFlg,EFH4 
A, HrzScrlCnt 
EFH6 - 


A,RO | 
A,HrzCurPxt 
Rt,A 

A, HrzPxtShf 
A,R1 - 

EFH3 
‘HrzCurPxl,A 
ScrlLtOne 
EFH5 


‘A, HrzCurPxl 
A, HrzPxlShf 
EFH/ 


Cc 

A, HrzCurPxl 
A, HrzPxlShf 
EFH7 


=e =e =e =e =a =e =. =a =e =e 


m/e Me we we Me BH Me le le le 


=e =e me =e 


Set end-of-frame flag and 

get out if not horz. scroll 
Get*out if no update for hz scr 
Save ) 

special function 

registers 
Reset update count 
Jump if in normal mode 
Char width in compressed mode 

~ and continue 


Char width in normal mode 


Jump if scrolling right 
Check char scroll count and 
jump if already at end 


Clear carry for below 
Char width 
Minus horz pixel offset is 
amount to scroll in this chr 
Amount shifted each time 
minus amount left this chr 
skip if this char is enough 
Else store new pixel offset 
and go to next character 
Go check for end of scroll 


Current pixel offset 
plus amount to shift gives 
new pixel offset; continue 


scroll 

Clear carry for below 

Current pixel offset ‘in char 
minus # shifted each time 

Continue if still in char 


A,RO 
HrzCurPxl,A 
A, HrzScrlCnt 
EFH6 
ScrlRtOne 


HrzScrlCnt, EFH8 
HrzDirFlg,EFH8 


HrzCurPxl,#0 


_ HrzFrmCnt, #1 


EFH8 


HrzCurPxt , #0 
HrzScrlFlg 
PlcCsr 
MsgActFlg,EFH8 
SetWndPos 
WndVisFlg,EFH8 
ShwWnd 

EFH8 


. 
f 
® 
a 
s 
as 
. 
£ 
. 
g 


Readjust to be in character 
and store new pixel offset 
Check char scroll count 
and jump if already at end 
Else, get next character 


: Check for end of scroll 


f 


. 
tf 
ry 
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Continue if more to scroll 
Finish last char for scroll rgt_ 
For left, set .to char boundary | 


and wait one more frame time 
-to actually finish 


: Actual finish of horizontal scroll 
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Set pixel offset to char bound 
Indicate no longer scrolling 
Place cursor (if possible) 

Get out if in message display 
Set window position if in bgd 
Get out if window not visible 
Show window if it should be 
Get out 


function char width and exit 
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: Final 


Get function attr (high byte) 
Mask off old width bits and 
put in new width | 
Write new high byte of attr 
Point to low byte 
Get low byte of function attr | 
Mask off old width bit and 
put in new one ; 
Write new low byte of attr 
Restore 
special function 
registers 
exit 
Restore flags and reg bank 
Exit from interrupt 





EFH7: 
MOV 
EFH8: 
SETB 
MOV . 
SUBB 
DEC 
MOV 
SWAP 
ANL 
MOV 
MOV 
ANL 


HrzCurPxl,A 


C 

A, #12 

A, HrzCurPxl 
A 3 


-RO,A 


A 
A, #080H 
R1,A 
A, #007H 
A, RO 


; In middle of character 


f 


Keep new pixel offset 


Set up for function character width 


Full 
maximum width 
minus pixel offset 
minus two (for Am8152) 
Keep new width 


Most sig bit of width to bit 7 


and all else masked off 

then keep for low attr byte 
Mask off all but 3 low bits 

of new width 


ACC.3 

R3,A 

EndFrmF lg 

THO, #END_FRM_CNT HI 
TLO,#END_FRM_CNT_LO 
CsrShwFlg,AHO . 
CsrShwFlg 
CsrSetFlg 

AH1 


CsrSetFlg,AH1 
CsrSetFlg 


=s =e &e8 =e | =e 8 ma |] 


Clear the condition 
and keep it 
Reset end-of-frame flag 
Reload 
' end-of-frame counter . 
Skip if not requesting cursor 
Reset cursor request and 
defer actual action- 
until next frame — 


Skip if no deferred cursor req 
Reset deferred request flag 


Get byte with enable bit and 
set it (shows cursor) 
then put that byte back 


then keep for high attr byte | — ~ A,R2 
Point to bgd function attribute ACC.7 
and use it unless in message A,R2 


™~ 


MOV -RO,A: 
MOV. DPTR,#BgdFncAtr0 
JNB  MsgActFlg,EFH10 


2 
f 
. 
a 
° 
’ 
. 
rd 
° 
s 
° 
" 
e. 
’ 
o 
’ 
. 
fA 
. 
’ 
. 
a 
s 
’ 
« 
’ 


“=e "es “@8 Se Me 


MOV DPTR,#MsgFncAtr Point to msg function attribute 


7-d 


SJMP 


SEE EEE EEE EEE EEE EEE EE EEE EEE EEE EE EEE TEEPE EEE E EET EEE EEE EEE EE 


SKIP 


EFH10 . 


Am8052HdL: 


me &s Me MR Oe 


PUSH. 


PUSH 


PUSH - 


MOV 


MOV 


JNB - 


turning the cursor on. 
vertical retrace and is fully discussed in Am8052 technical documents. 


ACC 
DPH 


DPL 
R1,#ModReg2Ind . 
LCALL RdAm8052Reg 


A,R3 


ACC.3,AH1 


s 
a 
. 
’ 


and use it 


SEEEETETETEEET EEE EE EE ESET ET EE EEE EE EEF EE ETE TEE T EET E TET E ETE E EE TT EEE TEE EE ET EEE 


Handles the vertical event and smooth scrolling interrupts from the Am8052. 
The vertical event.is set to occur during vertical retrace. and is used to 
reset the visible scan line counter. We also use this time to synchronize 


The smooth scrolling interrupt also occurs during 


=e =e =e =e =e =e =. 


Save 
special function 
registers 
Read interrupt pending 
status from Am8052 
Check vertical event pending 
and jump if not 


ACC.0,AH3 


WrAm8052Reg 
DPL 
DPH 
ACC 
PSW 


ACC.0 

R7,A 

A,R2 — 

R6,A 
VrtScrlNewFlg 
ACC.0,AH6 
SudBit,AH5 

A, VrtSerlCnt 
ANA. 
VrtScerlCnt 
AH7 . 
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Jump if a smooth scroll intr 


Update Am8052 status 
Restore 
special function 
registers 
Restore flags and reg bank 
Exit from interrupt 


ra 


Clear smooth scrolt condition 
Keep Low . 
and high 
bytes of status 
Signal extra row now available 
Jump if scrolling continues 
Jump if scrolling up 
Check for late continuation of 
up scroll, jump if not 
Allow for extra call when - 
scrolling up and cont inue 





AH4: ° AH11: 
‘LCALL SetAftScrlDn ; Clean up after scroll up CLR CurMDBFlg 
- . ; MOV RO, #BgdMDBO.AN.OFST+MDB_RowPag 
AH5: MOV -R3,#BgdMDBO.AN.OFST 
CLR VrtScrlFlg ; Indicate no longer scrolling MOV R5,#BgdMDBO.AN.OFST+MDB Scrl 
LCALL PicCsr *.Place cursor (if possible) 
SJMP AH16 ; Go restore status for exit AH12: 
JB SudBit , AH14 Jump if ‘scrolling up 
AH6: ; Continue scrolling JNB VrtSerlFlg,AHi2a . Skip if first row in down scr 
JNB  WndActFlg,AHt0 ; Jump if in background LCALL SetAftScrlDn Clean up after a scroll down 
MOV RO,#WndWDOBO.AN.OFST+WDB RowPag ; Set up for window scrolling | ; 
MOV R1,#TOWSftLoInd | . AH12a: 
MOV R3,#WndWDBO.AN.OFST SETB VrtScriFlg 
JB CurWDBFlg,AH7 “ DUNZ VrtScrlCnt,AH13 
SETB CurWDBFlg , MOV DPH,R2 
MOV R2, #WndWDB1.SR.PAGE MOV DPL,RO 
SJMP AH8~ MOV A, TopRow 
MOVX a@DPTR,A 
AH7: | MOV A,ScrlByt 
CLR CurWDBFlg ; CLR ACC.0O 
MOV _ R2,#WndWDBO.SR.PAGE SJMP AH15 


Indicate scroll in progress 
Jump if more after this 
Point to row pointer 
in appropriate block 
and make it point to top 
visible row 
‘Get scroll control byte 
and set up to stop 
after this last row 
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AH8: . AH13: 
JNB CurMDBFlg,AH9 : LCALL SetForScrtDn 
MOV R5,#BgdMDB1.AN.OFST+MDB_ Scrl MOV DPH,R2 
SJMP AH12 . MOV DPL,RO 
: MOV “A,R4 


Set up to scroll another row 
Point to row pointer 
in appropriate block 
_and make it point to top 
visible row 
Get scroll control byte 
and continue scrolling 


AH: - 2) MOVX @DPTR,A 
MOV R5,#BgdMDBO.AN.OFST+MDB_ Scr | MOV A,ScrlByt 
SUMP AH12 | SUMP AH15 


=e =e =e =. =8 =e =e 


AH10: AH14: 

MOV R1,#TOPSftLoInd Set up for background scrolling . SETB VrtScrlFlg 

MOV _R2, #BgdMDBO.SR.PAGE LCALL SetForScrlUp 

JB CurMDBFlg,AH11 . -- | MOV  DPH,R2 

SETB CurMDBFlg MOV DPL,RO 

MOV RO, #BgdMDB1.AN.OFST+MDB_RowPag MOV A,R4 

MOV -R3,#BgdMDB1.AN.OFST a MOVX @DPTR,A 

MOV 5, #BgdMDB1.AN.OFST+MDB. Scr MOV A,SerlByt 

SUMP AH12 ~ DJNZ VrtScriCnt,AH15 
CLR ACC.0 


Indicate scroll in progress 
Set up to scroll another row 
Point to row pointer 
in appropriate block 
and make it point to top 
visible row 
Get scroll control byte 
Jump if more after this 
Else set up to stop scroll 


=e =e =e =e =6 =e =5 =e =e 
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AH15: 


 AH16: 


HstComHdl: 


MOV DPH,#BgdMDBO.SR.PAGE 
MOV DPL,R5 

MOVX . @DPTR,A 

LCALL WrAm8052Reg 


MOV R1,#ModReg2Ind 
MOV A,R6 
MOV R2,A 
MOV A,R7 
MOV R3,A 


~ AJMP AH2 


SKIP 


~ 


’ 


Point to 
- appropriate MDB and put - 
in new scroll control byte 
Write new block (MDB or WDB) 


Ready 
to restore status 


* Go restore status 
SEE EEEEEE EEE EEE EEE EEE LETTE EEE EE EE TE EEE EE EEE TEE EEE ETE T EEE EEE EE EEE Ee 


SEEFEEEEL EEE EEE EEETEETE TEE E EEE EEE TET T TE Eth t Ft ttt ttt ttt ttt ttt ttt ttt ttt tt tt ttt 


Handles host communications using the 8751's on-chip asynchronous serial 
port feature. Currently, only reception from the host is supported, but 


transmission can be easily added. 


PUSH ACC 
PUSH - DPH 
PUSH DPL 
JNB RI, HCH4 


CLR RI 


MOV -DPH, #HstRcvBuf.SR.PAGE 


MOV DPL,HstRcvinsOff 


CLR C 
MOV A,HstRevCnt 
SUBB A,#80 
JNC  HCH3 


ADD A, #NEAR_FULL_CNT 


_ JNC  HCH1 


SETB HstRcvBsyFlg 


us 


- Preserve accumulator 


and 
data pointer 
Jump (to xmt) if no rcv intr 





- Reset receiver intr condition 


Point to ring buffer 
insertion Location 
Ensure no interference w/SUBB 
Current number of chars in ring 
compared with maximum 
Jump (to exit) if ring is full 


Check for nearly full ring 
Jump if plenty of room 


Signal busy if nearly full 









HCH1: 
MOV 









MOV 
INC 
JNZ 







MOV 
HCH2: 

MOV 

INC 
HCH3: 


















‘POP 
POP 
POP 
RETI 









HCH4: 
CLR 









NOTE: 
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SJMP 























MOVX 


POP - 


TERELEELEEEEAE EES ELE EEE ESE EE EEE EEE EEE AT EEE EEE AEE EEE EEE EEE TEE T TE TTT EFT EEE E tt tt tt 


; end of C Base 





3; Read and store character 
Get character from host 


A, SBUF : 
-QDPTR,A ; and store it in ring buffer | 
A, HstRevinsOf f ; Insertion location now | 
A . ; incremented to next location 
HCH2 ; Jump if still in buffer range 
A, #HstRcvBuf .AN.OFST Reset to start if past end 


; Finish receiver interrupt 

HstRevinsOff,A ; Keep new insertion location 

HstRevCnt “ s New number of chars in ring 

; Common interrupt exit (rcv and xmt) 
Restore data pointer 


DPL : 
DPH . ; and 
ACC sd 7; accumulator 
PSW ; Restore flags and reg bank 
; Exit from interrupt 
; Transmitter interrupt handler 
TI. ; ; Reset transmit intr condition 


There is currently no software support for transmission to the host. 
This part of the handler merely shows where actual code to support’ 
this capability would be placed. 


HCH3 + Go to exit 





— 










ngo5it | MOV 


TITLE " - CALEB 0.00 Initialization" MOV 
SHEET EEEE EERE EEE EEE TEEPE EEE EEE EEE EEE EEE EEE EEE EE EEE EEE EEE EET EEE EEE EEE Ett 


C Init CALEB 0.00 


- 


Copyright 1985 Advanced Micro Devices, Inc. 
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“This file contains the reset, memory test and initialization code. 


NAME "Initialization" 


DisCon “: in C_Switch 


in C_Util 
> in C Util 
in C_Util 


WrFntCel ,HidCsr,ShwCsr 
EXT DlyTilEndFrm, WrAm8052Reg,RdAm8052Reg _ 
EXT HalfSwap 


EXT Fnt_7x9,Fnt_5x7 ; in C_Font 


EXT DblBaudOpt, BaudRatCnt in C_Config 


SEEEEEEEE PEELE EEE EEE EEE EEE TEE E EEE EEE LTTE EEE EEE E EEE E EFT E FETT Ft tt FTF T FTF ttt ttt 


SKIP 
INCLUDE C_MemMap 


SKIP 
SEEEEEEEEEEEEEEF ELE EE EEE EE EAE EEE E EEE E EEE EEE EEE EEE EEE EE ETE EEE E EEE E ETE EEE tt 


Reset: ; Reset procedure 


This is the beginning of the reset procedure. We get here either from a 
power-on condition (i.e. chip reset) or a Reset To Initial State (RIS) | 


- 
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control from the host. 


IE, #0 
P1,#0EDH 


P3,#0FFH 


PSW,#0 

SP, #067H 
R1,#ModReg1 Ind 
R2,#0 

R3,#0 
WrAm8052Reg 
IP, #007H 


TMOD , #025H 


TCON, #055H 
SCON, #050H 


DPTR, #Dbl BaudOpt 
A, @A+DPTR 

PCON, A 

DPTR, #BaudRatCnt 
A 
A, @A+DPTR 

THI,A 

TL1,A 

THO, #END_FRM_CNT HI 
TLO,#END_FRM_CNT-LO 
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Disable all interrupts 
Ensure 7: HstXmtBsyFlg->input 
6: HstRevBsyFlg->busy _ 
5: KbdRcvRdyFlg->input 
“4: KeybrdEnbFlg->disable 
3: Am8052XfrBit->high 
2: Am8052BusAck->high 
“1: AMDSPMBit ->low 
0: (unused) ->input 

Ensure special functions and 
marking output to host. 

Ensure normal register bank 

Base of 24-byte stack 

Mode Register 1 
gets zeroes 
to 
disable the display. 

Bus request (INTO), end-of- 
frame (T0) and Am8052 (INT1) 
are high priority; serial 
and unimplemented (11) low 

Timer 1 (mode 2) for baud rate; 
timer 0 (counter, mode 1) 
for end-of-frame interrupt 

Both timers on; 
edge triggered interrupts 

Serial mode 1 (8-bit, variable 
baud rate); receiver enabled 

Load double baud option for 
PCON contents 
OOH for normal speed 
80H for doubled 

Load baud rate count 


End-of-frame interrupt occurs 
28 scan lines from bottom 





ALL of display memory will now be tested. An alternating bit test is 
performed followed by an address test. Here we begin to write the first 
pattern set for the alternating bit test. . : 


MOV 2, #DspMemBas.SR.PAGE 
MOV RO, #DspMemBas.AN.OFST 
MOV A, #0AAH 

MOV MemTstTmp,A 

MOV R7,#0SP_MEM_SIZ.SR.PAGE 


Start at first byte of 
display memory , 
Initial test pattern also 

saved for verification 
Number of pages to test 


1 
=e =e =a =e =e 


MT1: 8 a "+s For each page 
MOV R6, #4 ig / : Number of groups per page 


“MT2: For each group in a page 
MOV R5,#PAG_SIZ/4 | ; Number of bytes per group 


MT3=> a, ; each byte in a group 
MOVX @RO,A Write test pattern to memory 


INC RO ; . . then address next byte 
i 


DJNZ R5;MT3 ~ Loop until end of group 
CPL OA. 3; Change pattern for next group 
DJNZ. R6,MT2 . : Loop until end of page. 


INC P2 : Address next page 
DJNZ R7,MT1 ; Loop until end of memory 


Next, the patterns are verified. As each byte is checked the complemented 
pattern is written back. This section is performed twice so that each bit 
is tested with both a one and a zero. 


Verification (done twice) _ 
P2,#D)spMemBas . SR. PAGE : Start at first page (RO is 0) 
R7,#DSP_MEM_SIZ.SR.PAGE ; Number of pages to test 


--For each page 
~ -R6, #4 ; Number of groups per page 


: For each group in a. page 
RS, #PAG_SIZ/4 . - » Number of bytes per group 


MT7: each byte in a group 


MOVX A,@RO ; Read memory, check expected 
CJNE A,MemTstTmp,RstErr . : pattern and quit on an error 


Change pattern and 
write it to'memory — 
then address next byte 
Loop untit end of group 


CPL A 
MOVX @RO,A 
INC RO 

DJNZ -R5,MT7 


=a =e ese se 


Save next verification pattern © 
Loop: until end of page 


MOV MemTstTmp,A 
DJNZ. R6,MT6 


INC P2 Address next page 
DJNZ R7,MT5 Loop until end of memory 
CPL A +. % 

MOV MemTstTmp,A 

CUNE -A,#0AAH,MT4 . -3 Verify again, if first time 


The display memory has passed the alternating bit test; now the initial 
address test patterns will be written. Each byte's offset address (within 
it's page) is exclusive-or'ed with it's page address. This ensures a 
different pattern for each byte in a page and for each byte at the same 
offset in different pages. , “eae 
MOV R2,#DspMemBas.SR.PAGE ; Start at first page (RO is 0) 
MOV R7,#DSP_MEM_SIZ.SR.PAGE ; Number of pages to test 


MT8: . For each page 


MOV P2,R2 ; Address page 


MT9: © ; For each byte in a page 


MOV A, RO 
XRL A, R2 
MOVX @RO,A 
DJNZ RO,MT9 


Make pattern from offset and 
page address Oe 
Write test pattern to memory 
Loop until page is finished 


=e Ss Se 


INC R2 3 Prepare for next page - 
DJNZ R7,MT8— -  ¢ Loop until end of memory 





Next, the address patterns are verified. As each byte is checked a zero 
is written back. . This aids the verification process as well as providing 
a basis (all zero memory) for subsequent display memory initialization. There is currently no test of the Am8052. A ‘simple accessibility 
test, which writes and verifies patterns in the read/write registers 
of the Am8052 could be added here. THIS TEST SHOULD LEAVE -THE 


Am8052 DISABLED AT ALL TIMES. 


MOV R2,#DspMemBas.SR.PAGE ~ ; Start at first page (RO is 0) 


me me we =e 


MOV R7,#0SP_MEM SIZ.SR.PAGE ; Number of pages to test 


The Am8052 is now known to be accessible. We assume it works and begin 

it's initialization. The display is already disabled; all. other registers 
will be written except Mode Register 2. This latter is deferred until after 
the display is enabled. | 


MT10: —_ For each page 
MOV P2,R2 — ; Address page 


=. =e =e =e 


MT11: ; For each byte in a page 
MOV A,RO ; Make pattern. from offset and ; air 
XRL A,R2.. °° | : page address then MOV R1,#AtrEnbInd sAttribute Port Enable 
MOV MemTstTmp,A So . save for verification check MOV R2,#067H ; 
MOVX A,@RO  - >. , » Read memory, check expected MOV R3,#0FFH 
CJNE A,MemTstTmp,RstErr : pattern and quit on an error LCALL WrAm8052Reg ; 
; a a MOV R1,#AtrRdfInd ;Attribute Redefinition 
CLR A - Write zero: MOV R2,#000H . | 
MOVX @RO,A | to memory MOV. R3,#000H 
DJNZ RO,MT11 -- + Loop until page is finished LCALL WrAm8052Reg . | 
= . MOV R1,#TOPSftHiInd : ;Top of Page Soft Pointer 
INC R2 ; Prepare for next page LCALL WrAm8052Reg 
DJNZ R7,MT10 -; Loop until end of memory . . MOV R1,#TOPSftLoInd 
LCALL WrAm8052Reg oe 
Display memory is now tested and initialized to all zeroes. We proceed with | MOV | R1,#TOWSftHiInd sTop of Window Soft Pointer 
testing the. Am8052.- ms LCALL WrAm8052Reg 
. MOV . R1,#TOWSftLoInd 
SUMP ATI a LCALL WrAm8052Reg 7 
2% MOV. R1,#AtrFlgInd ;Attribute Flag 
7 FEEEEEEEE EERE EE EEE EERE EEE EE SEEPS EEE EEE EEF EEEEPEEE EEE EEE TEEPE PETE ttt ttt ttt LCALL wWrAm805 2Reg : 
| a MOV R1,#TOPHrdHiInd ;Top of Page & Wind Hard Pointers 
RstErr: oo | LCALL WrAm8052Reg - 7 high word =O © 
. r - . MOV _R1,#TOWHrdHilnd 
ae Gy some initialization error occurs then the following procedure is — LCALL WrAm8052Reg " 
3; executed. MOV R1,#TOPHrdLoInd ;Top of Page & Wind Hard ready 
: ~ 3 MOV R2,#CLrFntMDB.SR.PAGE - > for font load 
SUMP $ - .. | : Currently we just stick here MOV -R3,#CLrFntMDB.AN.OFST : 


° 
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LCALL WrAm8052Reg 

MOV = R1,#TOWHrdLoInd 
MOV R2, #CLrFntWOB.SR.PAGE 
MOV R3,#ClrFntWDB.AN.OFST 


- LCALL WrAm8052Reg = * 


MOV _R1,#DMABstInd 
MOV R2,#010H 

MOV R3,#040H 

LCALL WrAm8052Reg 

MOV RI, #VrtWthInd 
MOV R2,#002H 

MOV ‘R3,#04FH 

LCALL WrAm8052Reg 

MOV -—_R1,#VrtActLnelInd 
MOV - R2,#001H 

MOV R3,#067H 

LCALL WrAm8052Reg 

MOV R1,#VrtTotLneInd 
MOV R2,#001H 

MOV ~R3,#06CH 

LCALL WrAm8052Reg ,- 
MOV R1,#HsyncVIntInd 
MOV R2,#001H 

MOV _R3,#020H. 

LCALL WrAm8052Reg 

MOV _R1,#HDrvind 

MOV R&,#000H 

MOV R3,#020H 

LCALL WrAm8052Reg 

MOV R1,#HScnDLyI nd 
MOV -R2,#000H 


MOV R3,#022H 


LCALL WrAm8052Reg 


MOV R1,#HTotCntInd 


MOV R2,#000H 
MOV R3,#0DBH 


. LCALL WrAm8052Reg 
- MOV R1,#HTotDspInd 
-MOV . R2;#000H 


MOV R3,#0D9H 
LCALL WrAm8052Reg 


;DMA Burst and Space 


7Vertical. Syne Width 
: and Vertical Scan Delay 


s 


:Vertical Active Lines 


Vertical Total Lines 


sHorizontal Synch Width 
- and Vertical Event Row 


’ 


sHorizontal Drive 


sHorizontal Scan Delay 


sHorizontal Total Count 


sHorizontal Total Display 
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We next initialize a portion of display memory. in a special way which 
is used only for initially blanking the character generator RAM. This 


clear font display requires only a single main definition block, sixteen 


row control blocks (each with its own single character), and two attribute 
words and a row redefinition block which all RCBs use in common. There is 
also a termination window definition block. 


NS 


First, the main definition block is written. . Since memory is known to - 


_contain all zeroes, only those parts of the MDB with non-zero values will 


be written. 
Address page of the MDB at 
offset of top row pointer 
Point to page 
of top row 
and 
its offset 


MOV 2, #CLrFntMDB.SR.PAGE : 
MOV RO, #CLrFntMDB.AN.OFST+MDB_RowPag : 

MOV A,#CIrFntRCBBas.SR.PAGE : 
-MOVX @RO,A : 

INC RO : 

MOV A, #CLrFntRCBBas.AN.OFST : 

MOVX @RO,A : 

INC RO . : 

MOV A,#-1 ; Impossible cursor position 
MOVX @RO,A : entered for x 

INC RO : and | 

MOVX a@RO,A ; for y : 

INC RO : 

MOV A,#001H ; 

MOVX @RO,A : 

MOV RO, #CLrFntMDB.AN.OFST+MDB_Tslc : 

MOV A,#15.SL.2 : 

MOVX @RO,A : 


Set the FAT bit to fetch 
an attribute for fill chars 
Set MDB's TSLC field to 
15 (which means 16 scan 
lines per character row) 


Next, each of the sixteen row control blocks is initialized. Again, only. 
non-zero bytes are written. — 


MOV R2,#CirFntRCBBas.SR.PAGE 
MOV R3,#CirFntChrBas.AN.OFST 
MOV R4,#CIirFntAtr.SR.PAGE 


Address page of first RCB 
Address offset of character 
Address page and 


MOV R6, #CLrFntRRB.SR.PAGE 
MOV R7,#CLrFntRRB.AN.OFST 
MOV R1,#16 


Address page and N 
offset of row redef block 
Number of RCBs to be made 


; 
: 
; 
- MOV R5,#CIirFntAtr.AN.OFST : offset of attributes. 
; 
; 





TT-d 


Address page and 
offset of first attribute 


CF1:- > MOV P2,R4 : 
MOV -P2,R2 ; Address RCB at MOV RO, #CIirFntAtr.AN.OFST ; 
MOV RO, #CLrFntRCBBas.AN.OFST+RCB_RdfLnk Link bit offset (1st byte) MOV A,#047H + Set cursor bit and width to 
MOV A,#080H j » Set redef block link bit , MOVX a@RO,A : load data for 7x9 chars 
“MOVX @RO,A. ‘; to indicate RRB ptr present INC RO ; initially, also 
MOV A,RO ; Offset of RCB to be written MOV. A,#010H : ‘set required superscript 
MOV RO,#ClrFntRCBBas.AN.OFST+RCB RowOff ; as offset of next RCB MOVX @RO,A ; attribute 
MOVX @RO,A | , : (all RCBs at same offset) INC RO : 
MOV RO, #ClrFntRCBBas.AN.OFST+RCB_1st+SEG_NumVis . MOV A,#087H : 
MOV A, #1 ; One character specified per row | MOVX @RO,A : 
MOVX @RO,A™ . -~ F (rest are filled with null) 
MOV RO, #CLrFntRCBBas.AN.OFST#RCB_1st+SEG_ChrPag . s And now, the row redefinition block is initialized to load zeroes into each 
MOV A,R2 : ; Put in page address s slice of each character. This is done by leaving the row attribute fields 
: all zeroes and forcing all slices of a character to be loaded with each row. 


Second word is latched, 
nothing special attribute . 


MOVX @RO,A : of char (same as its RCB) | 
INC RO » ‘and then’ 
MOV A,R3 : its offset MOV. P2,R6 ; Address page and 
-MOVX @RO,A ; | MOV RO, #CLrFntRRB.AN.OFST : offset of RRB 
MOV RO, #CLrFntRCBBas.AN.OFST+RCB_1st+SEG_AtrPag . MOV A,#15.SL.2. . ; Set 16 scan lines per row into 
MOV - A,R4 i Put in page address MOVX @RO,A :  RRB's TSLC field (1st byte) 
MOVX @RO,A > . _ of attributes » MOV RO,#CIrFntRRB.AN.OFST+RRB_SpcsLo Spce; Set superscript start/end lines 
“INC. RO | ; and then ; ~ MOV A,#15 : to 0 and 15 so that it spans 
MOV A,R5 ; . their beginning offset MOVX @RO,A . : the entire character -row 
MOVX @RO,A . | . ; MOV RO, #CirFntRRB.AN.OFST+RRB CursLo Cure; Set cursor start and end lines © 
- MOV RO, #ClrFntRCBBas.AN.OFST+RCB_ClrRdfPag . MOV A,#15 - : to 0 and 15 so that it spans 
MOV = A,R6 - sg: Put in page address MOVX @RO,A : the entire character row 
MOVX @RO,A ; of row redef. block 
INC RO a: and then ; Finally, a window definition block is defined with its positioned near the 
MOV A,R7 ; its offset ; bottom of the display. It will be fetched by the Am8052 and show the first 
MOVX @RO,A ; ;. Of the. blanked character rows. | 
INC R2 . . '; Prepare for next page 3 
MOV RO,#CLrFntRCBBas.AN.OFST+RCB RowPag ; Put next page address MOV P2,#ClrFntWDB.SR.PAGE 
MOV A,R2 ae into- page address | MOV RO, #CLrFntWDB.AN.OFST+NDB_RowPag 
MOVX @RO0,A +2 for next. RCB MOV A, #CIirFntRCBBas.SR.PAGE 
DJNZ R1,CF1 : _ ¢ Loop until all RCBs are written MOVX @RO,A 
DEC A "sg Make the last RCB INC RO 
MOVX @RO,A os : point to itself MOV .A,#ClrFntRCBBas.AN.OFST 
: _- MOVX- @RO,A 


Address WDB at 
offset to top row pointer 
Point to first RCB (just in 
case) 


= . 
=e Me =e =e =s S28 “We 


Then, we initialize the attribute words. The first one is set to force 
a load of character generator RAM. The ‘second is a latched but otherwise 
innocuous attribute which is fetched for the fill characters. 


s 
f 
e 
£ 
. 
e 
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Z1-a 


“+ MOV 
MOV 
MOVX 
INC 
MOV 
“MOVX 
INC 
MOV 
MOVX 
INC 
MOV 
MOVX 


We next set things in motion. 
is enabled. 


RO, #CL rFntWOB.AN.OFST+WDB_ NxtPag 


A, #CLrFntWDB.SR.PAGE 
aRO,A : 
RO 


A, #ClrFntWOB.AN.OFST 


aRO,A 
RO 
A, #20 
@RO,A 
RO 


A, #21 


aRO,A 


, 


generator RAM. 


MOV 
MOV 
MOV 
MOV 
LCALL 
MOV 
MOV 
MOV” 
-LCALL 
LCALL 


Now we 


° 
f 
. 
g 
. 
f 


CFe: 
CLR 


CF3: 
‘MOV 
MOV 
MOV 
~LCALL 


v 


IE, #087H 
R1,#ModReg1Ind 
R2,#0C8H 
R3,#001H 
WrAm8052Reg 
R1,#ModReg2Ind 
R2,#096H 
R3,#0D2H 
WrAm8052Reg 
DlyTilEndFrm 


make it point to itself 


‘Set second from bottom row 
for start . 
and 
bottom partial row 
for end 


. 
e 
. 
s 
. 
ti 
. 
’ 
° 
f 
. 
f 
. 
s 
° 
& 
. 
tf 
s 
a 
. 
f 
e 
a 


Interrupts are enabled and the display 
We need the Am8052 epshanng: in order to load the character 


Enable interrupts (not serial) 

Enable the Am8052 display 
operations 

Enable Am8052 vertical 


einterrupt 


Be sure that all is working 


will zero the entire character generator. This section is done 


~ p2,#ClrFntChrBas.SR.PAGE 


RO, #CLrFntChrBas.AN.OFST 
R7, #16 
DlyTilEndFrm 


twice; first for the 7x9 characters and then for the 5x7 characters. 
- Sixteen character cells are cleared in each frame. 


For each set . of chars (7x9 & 5x7) 


: Start with null (char code 0) 


For each frame (group of 16 chars) 


; Address page and 

; offset of first character 
: Number of characters to load 
; Wait. for an auspicious omen 


-Address pointer’ to next WDB and > 


CF4: 

- MOVX 
INC 
INC 
DJNZ 


JNZ 


LCALL 


MOV 
MOVX 
CJNE 


MOV 
MOVX 
SJMP 


s 
a. 
. 
f 


CF5: 
MOV 
- MOV 
MOV 
MOV 


p2 
A 
R7,CF4 


* 


CF3 


DlyTilEndFrm 
DPTR, #ClrFntAtr 
A,@DPTR 


A, #047H,CF5. 


A, #044H 
@DPTR,A 
CF2 


IE, #0 

R1, #ModReg1Ind 
R2,#0CCH 
R3,#001H 


LCALL WrAm8052Reg 


. 
v 
. 
f 


MemInt: 
MOV 

_ MOV 
MOV 
IntVar: 
MOV 
INC 
DJNZ 


for normal operation. 


-R1,#126 


A, #00H 


‘RO, #02H 


-@RO,A 


RO 
R1, IntVar 


Now that the character generator RAM is cleared we need to disable the 
Am8052 in preparation for initializing memory for actual operation. 


*. 


each character Crow) in the frame 

Store code of char to be loaded 

Next page (next character) and 
next cell to be loaded 

Loop until frame is set up 


fs 
. 
tf 
* 
s 
. 
f 


‘Loop until back to null char 


Ensure that we are finished 

Check first attribute for 
width of load character | 

Skip if just loaded 5x7 chars | 


os =e Me =e 


Else, set up to load 
5x7 set and 
go do it 


- Finished clearing character generator 
Disable all interrupts 
Using Mode 1 Register 

blank display (VB=1) 

but leave Am8052 enabled 


ba) as =e =e =e 


- The following code initializes all of memory, both internal and external, 


: Clear all but RO-and R1 


f 


> Loop point for clearing variables 
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CurAtr, #00H 

ActCol , #00H 

ActRow, #07H 

CurRow, #WndRCB7.SR.PAGE 
VisCol , #00H 

VisRow, #07H 

BgnRow, #WndRCBO.SR.PAGE 
TopRow, #WndRCB7.SR.PAGE 
BtmRow, #WndRCB13.SR.PAGE 
RemRow, #WndRCB13.SR.PAGE 
EndRow, #WndRCB13.SR.PAGE 
ExtRow, #WndRCB14.SR.PAGE 


"R3, #WndVarBuf .SR.PAGE 
-R4,#WndVarBuf .AN.OFST 


Hal fSwap 

CurAtr , #00H 

ActCol , #00H 

ActRow, #00H 

CurRow, #MSgRCB.SR.PAGE 
VisCol ,#G0H a 


_ VisRow, #00H 
* BgnRow, #MSgRCB.SR.PAGE 


TopRow, #MSgRCB.SR.PAGE — 
BtmRow, #MSQRCB.SR.PAGE 


- RemRow, #MSQRCB.SR.PAGE 


EndRow, #MsgRCB.SR.PAGE 
ExtRow, #MSgRCB.SR.PAGE 


"R3, #MsgVarBuf .SR.PAGE 


R4, #MsgVarBuf .AN.OFST 
Hal fSwap 

CurAtr, #00H 

ActCol ,#00H 

ActRow, #06H 

‘CurRow, #BgdRCB6.SR.PAGE 
VisCol ,#00H 

VisRow, #06H 

BgnRow , #BgdRCBO: SR . PAGE 
TopRow, #BgdRCB6. SR.PAGE 
BtmRow, #BgdRCB29.SR .PAGE 
RemRow, #BgdRCB29.SR.PAGE 


wa wh Me lM 


=. mae =e =e =s =e 


7 @e =e mae =e =e 


=e =e =e =e =e =s 


=e =s =e @s =8 


=e Fs es =. 


Initial attribute is 00 
Initialize to leftmost col — 
First window row is 7th in list 
Page value to active row 
Always 0 in window 


Page value to beginning of list 
Page value to Am8052 bgn of (st 


Page value to last visible row - 


Page value to rows below dsp 
Page value of Last row in list 
Page value of extra 


Initial attribute is 00 
Initialize to leftmost col 
First msg row-is first in list 
Page value to active row 
Start left aligned 


Page value to beginning of List 
Page value to Am8052 bgn of Ist 
Page value to last visible row 
Page value to rows below dsp 
Page value of last row in list 
Page value of extra 


Initial attribute is 00 
Initialize to leftmost col 
First bgrd row is 6th in list 
Page value to active row 
Start left aligned 


Page value to bgn of list 
Page value to Am8052 bgn lst 


‘Page value to last visible row 


Page value to rows below: dsp 


MOV EndRow, #BgdRCB29.SR.PAGE ; Page value of last row in list 
MOV ExtRow, #BgdRCB30.SR.PAGE : Page value of extra 
MOV R3,#BgdVarBuf .SR.PAGE 
MOV R4,#BgdVarBuf .AN.OFST 
LCALL Hal fSwap 
‘MOV. . DspWid, #80 :Set parameters used in program 
MOV DspHgt , #24 : Many are offsets into pages 
MOV Col Add, #1 | 
MOV RowAdd,#0 
MOV RcbOff,#BgdRCBO.AN.OFST . 
MOV ChrOff,#BgdChrBuf0.AN.OFST 
MOV AtrOff,#BgdAtrBuf0.AN.OFST 
MOV WndCol , #28 

““SETB + CsrZonFlg 
MOV CsrSiz,#00FH 
MOV HstRcvinsOff ,#HstRcvBuf .AN.OFST 
MOV HstRcvExtOff, #HstRcvBuf .AN.OFST 


: Initialize characters and attributes for the background and the message row. 
:Background Row 0 page 
scount of rows (includes msg) 
;blank all characters 
srow loop point 
MOV RO, #BgdChrBuf0.AN.OFST ;offset of first character 
MOV R1,#128 2128 characters per row 
FilChr: scharacter loop point 
MOVX @RO,A . 
INC RO “next character 
DUNZ R1,FilChr 


MOV P2,#BgdRCBO.SR.PAGE 
MOV R2,#32 
MOV A,#' ! 

FilRow: 


send of row 
INC P2 snext row 
DJNZ R2,FilRow 
, 7P2 now points to attributes 
MOV R2,#32 232 rows again 
MOV R6,#000H 
MOV R7,#007H 
FilAtrRow: 
MOV RO,#BgdAtrBuf0.AN.OFST 
MOV R1,#128 


srow loop point 
roffset of attributes 
7128 per row 
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FilAtr: 
MOV 
MOVX 
INC 
MOV 
MOVX 
INC 
DJNZ 


INC 
DJNZ 


; Initialize the background row control blocks. 


7~ MOV 
MOV ~~ 


IntBgd: 
MOV . 


MOV 
MOV 
MOVX. 
MOV 


MOVX - 


MOV 


MOVX 


MOV. 
- MOVX 
MOV 
MOV 
MOVX 
MOV 
MOVX 
MOV 
MOV 
MOVX 
MOV 
MOV. 
MOVX 
MOV 
MOV 


yattribute loop point 


-A,R7 . ;set two bytes 


aRO,A 
RO- 
A,R6— 
@RO,A 
RO . mnext attribute 
R1,FilaAtr : 
send of row 
P2 mnext row 
R2,FilAtrRow : 


\ 


R2,#BgdRCBO.SR.PAGE ; s;page for row 0 control block 

R1,#31 = sonly initializing background. 
zbackground RCB init loop point 

P2;,R2 . " sset page of RCB 

RO , #BgdRCBO. AN. OFST#RCB_ RdfLnk sset flag to show row follows 


“A, #080H 


@RO,A 

RO, #BgdRCBO.AN.OFST+RCB_1st+SEG Cont ;1st is not Last seg 

aRO,A 7 a 

RO, #BgdRCBO.AN.OFST+RCB_2nd+SEG_ cont send is not last seg 

aRO,A . 

RO, #BgdRCBO.AN:.OFST#RCB_3rd+SEG Cont ;3rd is not last seg 

ARO, A | 

A, #BgdEncChr0.SR.PAGE “ spage for function character 
ap ae ieee ees zall func chars in 1 page 
aRO,A | : 

RO, #BgdRCBO.AN.OFST+RCB_1st+SEG AtrPag . ;same for attributes 
@RO,A - 2a | OM y . 

A, #1 - 


RO ne AN.OFST+RCB_1st+SEG_ NumVis “| function character (vis) 


aRO,A 


"A, #28 +28 characters in end segment 


RO, #BgdRCBO.AN.OFST+RCB_2nd+SEG_NumVis 


@RO,A 


RO, #BgdRCBO.AN.OFST+RCB_ist+SEG_ChrOff = ;function char pos 
A, #BgdFncChr0.AN.OFST 


aRO,A 


RO, #BgdRCBO.AN.OFST+RCB_1st+SEG AtrOff 


A, #BgdFncAtr0O.AN.OFST 

@RO,A 

RO, #BgdRCBO.AN.OFST+RCB_2nd+SEG ChrPag 
A,R2 

aRO,A- 


‘RO, #BgdRCBO.AN.OFST+RCB_3rd+SEG ChrPag 


@RO,A 

RO, #BGdRCBO.AN.OFST+RCB_4th+SEG_ChrPag 
@RO,A 

RO, #BgdRCBO.AN.OFST+RCB_2nd+SEG_Chroff 
A, #BgdChrBuf0.AN.OFST 

@RO,A 

RO, #BgdRCBO.AN.OFST+RCB_2nd+SEG AtrPag 
A,R2 

A, #20H 

aRO,A 


RO, #BgdRCBO.AN.OFST+RCB . 3rd+SEG | AtrPag 


@RO,A 
RO, #BgdRCBO.AN.OFST+RCB_4th+SEG AtrPag 


@r0,A 


RO, #8gdRCBO.AN.OFST+RCB_3rd+SEG NumVis 
A, #40 

@RO,A 

RO, #BgdRCBO.AN.OFST+RCB_3rd+SEG_Chroff 
A, #BgdChrBuf0.AN. OFST+28 

@RO,A 

RO, #BgdRCBO.AN.OFST+RCB__ 3rd+SEG Atroff 
A, #BgdAtrBuf0.AN.OFST+2*28 

@RO,A 

RO, #BgdRCBO.AN.OFST+RCB_4th+SEG NumVis 


A, #60 


@R0,A . 

RO, #BgdRCBO.AN.OFST+RCB_4th+SEG_ChrOff 
A, #BgdChrBuf0.AN.OFST+28+40 

@RO,A . 

RO, #BgdRCBO.AN.OFST+RCB. 4th+SEG AtrOff 


‘A, #BgdAtrBuf0.AN.OFST+2*(28+40) 


aRO,A 


' 3 -and attributes 


z;R2 has page for this row 


sset offset for char start’ 


‘; and-attrib start 


:set the attribute pages 


740 visible in 3rd seg 


360 visible in 3rd seg | 


“sstarting 28+40 after 1st 


attrib at 2*(28+40) 


a, 


‘pstarting 28 past first char » 


4 


attrib start 28*2 after ist | 
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MOV RO,#BgdRCBO.AN.OFST+RCB_BgdRdfPag yall point to same MOVX -@aRO,A 
MOV A, #NrmRRB.SR.PAGE >; row redef block INC RO 
MOVX a@RO,A , MOV A,#MsgFncAtr.AN.OFST 
MOV . RO,#BgdRCBO.AN.OFST+RCB_BgdRdfOf f MOVX @RO,A 
MOV A, #NrmRRB.AN.OFST ‘MOV = RO, #MsgRCB.AN.OFST+RCB_2nd+SEG_NumVis ;128 visible in next segment 
MOVX  @RO,A MOV A,#080H 
MOV A,R2 next page MOVX @RO,A 
INC A . » MOV RO, #MsgRCB.AN.OFST+RCB_2nd+SEG ChrPag ;characters in RCB page 
MOV" RO, #BgdRCBO.AN.OFST+RCB_RowPag 71s page in "next" Link MOV A,R2 
MOVX @RO,A - ' ; - MOVX @RO,A 
MOV R2,A 7 yand next. for loop INC RO 
DJNZ R1,IntBgd ) continue for 31 rows - MOV A,#MsgChrBuf.AN.OFST ; at msg buffer offset 
MOVX @RO,A 
; Initialize message Row Control Block MOV RO,#MsgRCB.AN.OFST+RCB_2nd+SEG_AtrPag sattrib page calculated 
| | MOV A,R2- : from RCB page 
MOV 2, #MsgRCB.SR.PAGE ORL A,#020H 
MOV P2,R2 , ; MOVX @RO,A 
MOV RO,#MsgRCB.AN.OFST+RCB_RdfLnk INC RO 
MOV A,#080H MOV A,#MsgAtrBuf.AN.OFST sattrib offset 
MOVX @RO,A- : | MOVX @RO,A | 
MOV RO,#MsgRCB.AN.OFST+RCB_RowPag 7"next" is last wnd RCB INC RO ’ sthen set row redef ptr 
MOV. A, #WndRCB14.SR.PAGE | | | INC RO 7 : to std location 
MOVX @RO;A 4 _. INC RO 
INC RO . | MOV A, #NrmRRB.SR.PAGE 
MOV A, #WndRCB14.AN.OFST : MOVX a@RO,A 
MOVX @RO,A° : ; INC RO 
MOV RO,#MSgRCB.AN.OFST+RCB_1st+SEG NumVis 71 visible in function MOV A,#NrmRRB.AN.OFST 
MOV. A,#1 MOVX a@RO,A 
MOVX @RO,A | | 
‘Mov RO, #MSgRCB.AN.OFST+RCB_1st+SEG Cont «3 18t seg is not last a We now initialize the Window memory. 
MOV A, #080H | 
MOVX @RO,A ; MOV P2, #WndChrBuf0.SR.PAGE :P2 points to first wnd row 
MOV RO, #MsgRCB.AN.OFST+RCB_1st+SEG ChrPag schar is in function page MOV R2,#15 . :R2 has count of window rows 
MOV A,#MsgFncChr.SR.PAGE , ' MOV _A,#' ! 7A has blank character 
MOVX @RO,A~ | , Fi lWndRow: : s;window row loop point 
-INC. RO MOV RO, #WndChrBuf0.AN.OFST _sset character offset 
MOV A,#MsgFncChr .AN.OFST schar is function char MOV R1,#40 | sR1 = character count 
MOVX @RO,A . . Fi lWndChr: swindow character loop point 
MOV ‘RO, #MsgRCB.AN.OFST+RCB_1st+SEG AtrPag ;attrib is func attrib MOVX 4@R0,A sblank the character 
MOV A,#MsgFncAtr.SR.PAGE — INC RO snext character 
‘DJNZ R1,FilWndChr 


. * 





znext row — ~ MOVX =@RO,A 
DUNZ R2,FilWndRow | 4 MOV RO, #WndRCBO.AN.OFST+RCB_WndRdfPag 
a a i ;done with window characters MOV | A,#NrmRRB.SR.PAGE ' 
;P2 = first wnd attrib page MOVX @RO,A . 
sR2 = count of rows - MOV” ‘RO, #WndRCBO.AN.OFST+RCB_WndRdfOff 


INC P2 - 
suse the std row redef > 


MOV P2,#WndAtrBuf0.SR.PAGE 
MOV’ R2,#15 


91-d 


MOV 


FilWndAtrRow: 


MOV 
- MOV 


FilWndAtr: 
MOVX, 


INC 
INC- 
DJNZ 


INC 


DJNZ . 


MOV 
MOV 
IntWnd: 
MOV 
MOV 
MOV 
MOVX 
“MOV 
MOV 
MOVX 
MOV: 
MOV 
MOVX 
MOV 
MOV 
MOVX 
MOV 
MOV 
ORL 
-MOVX 
MOV 
MOV 


A, #07 - - # 7A = initial attrib 


;window. row loop point 
RO, #WndAtrBuf0.AN.OFST 7RO 
R1,#40 7R1 

ae ;window attribute loop point 


ptr to attrib 
= attrib count 


@RO,A sset attrib 
RO . ;next attrib 
ROO : | ae 
R1,FilWndAtr 


P2 snext row 


R2,FilWndAtrRow 


R2, #WwndRCBO.SR.PAGE 


P2,R2 


RO, #WndRCBO.AN.OFST+RCB_RdfLnk 

A, #080H . 

aRO,A | 

RO, #WndRCBO.AN.OFST+RCB_Seg+SEG NumVis 
A, #40 

@RO,A 

RO, #WwndRCBO.AN.OFST+RCB_Seg+SEG ChrPag 
A,R2 | 

@RO,A . 
RO, #WndRCBO.AN.OFST+RCB_Seg+SEG_ChrOff 
A, #indChrBuf0.AN.OFST 

@R0,A 

RO, #WndRCBO.AN.OFST+RCB_Seg+SEG AtrPag 
A,R2 ; 

A, #010H- 

@RO,A 

RO, #WndRCBO.AN.OFST+RCB_Seg+SEG AtrOff. 
A, #wndAtrBuf0.AN.OFST 


~ 


with window attributes 
*R2 = window row 0 page 
R1,#15 RI 


= window row count 


point to wnd page 


sindicate row follows 


zone seg with 40 visible 
chars on same page 
> at buffer offset 


sattrib page calculated 
; from char page 


sattribute offset const 


MOV 
MOVX 
MOV 


~ MOV 
- MOVX 


MOV 
INC 
MOV 
MOVX 
MOV 
DJNZ 


A, #NrmRRB.AN.OFST 

aRO,A 

RO, #WndRCBO.AN.OFST+RCB_RowOf f 
A, #WndRCBO.AN .OFST 


@RO,A 


A,R2 

A 

RO, #WndRCBO.AN.OFST+RCB_RowPag 
@R0,A 

R2,A 

R1, IntWnd 


snext row at std offset 


; on next page 


snext row 


Initialize Termination Row Control block in last window row 


MOV . 
MOV 
MOV 
MOV 
MOVX 
INC 
MOV 


MOV . 


MOVX 


MOV 
MOV 
MOV 
MOV. 
MOVX 
MOV 
INC 
MOVX 
INC 


A, #WndRCB14.SR.PAGE 
TrmRow,A 


' P2,#BgdRCB29.SR.PAGE 


RO, #BgdRCB29.AN.OFST+RCB_RowPag 
arO,A 

RO , 

A, #ndRCB14..AN.OFST 

Trmoff,A 

@RO,A 


R2, TrmRow 

P2,R2 ; 

RO, #WndRCB14.AN.OFST+RCB_RowPag 
A,R2° 

@RO,A 

A, TrmOff 

RO 

@RO,A 

RO 

‘i 


ipage of. last window row 
: ‘is page of termination row 
zsmake row 29 last in brgd 


salso set termination offset 


2R2 =-P2 = termination row 


sterm row points to itself 


term row has no hidden chars 





L1-d © 


a 


=e 


MOVX 
INC 
MOV 

_MOVX 
MOV 
MOV 
MOVX 
INC 
MOV 
MOVX 


@RO,A 

RO 

A, #1 : 
@RO,A 

RO; #WndRCB14.AN.OFST+RCB_Seg+SEG_AtrPag 
A, #TrmAtr.SR.PAGE sterm attrib page 
aRO,A _ * 
RO. 

A, #TrmAtr.AN.OFST 
@RO,A 


and one visible char 


sterm attrib offset 


Initialize Function Character and Attribute 


MOV 
MOV 
MOVX 
INC 
MOVX 
INC 
MOV 
MOVX 


- INC 


MOV 
MOVX 
INC 
MOV 
MOVX 
INC 
CLR 
MOVX 


Initialize Termination Attribute 


MOV 
MOV 
MOVX 
INC 
CLR 
MOVX 


* 


DPTR,#BgdFncChrod- 
A,#! t 
@DPTR,A 
DPTR 
@DPTR,A 
DPTR 
A,#002H © 
QDPTR,A 
DPTR © 

A, #090H 
@DPTR,A 
DPTR 

A, #004H — 
@DPTR,A 
DPTR ; 
; | 
QDPTR,A 


:function characters are blank 


1st function attrib 


send function attrib 


™, 


x 


DPTR,#TrmAtr 
A, #087H 
QDPTR,A - 


stermination attrib 


‘DPTR' 


A 


‘@DPTR,A 


oy: 


Initialize Message Function Character and Attribute 


MOV DPTR, #MsgFncChr 
MOV A,#" ! 

MOVX @DPTR,A 

INC DPTR 

INC  DPTR 

MOV A,#002H 

MOVX @DPTR,A 

INC DPTR 

Mov A,#080H 

MOVX @DPTR,A 


s:function character is blank 


s function. attribute 


Initialize Background Main Definition Blocks 


MOV P2,#BgdMDBO.SR.PAGE 
MOV  R0O,#BgdMDBO.AN.OFST+MDB_RowPag 
MOV R1,#2 
InitMDB: 

MOV . A, TopRow 

MOVX @RO,A 

INC RO 

INC RO 

MOV A,#001H 

MOVX @R0,A 

INC RO 

MOV A,#000H 

MOVX 4@RO,A 

INC RO 

MOV A, #001H 

MOVX a@RO,A 

INC RO 

MOV A,#'! 
-MOVX @RO,A 

MOV A,RO 

ADD A, #5 

MOV RO,A 

MOV A, #034H 

MOVX @RO,A 

MOV RO,#8gdMDB1.AN.OFST+MDB_RowPag 


DJNZ R1,InitMDB 
22 


:P2 = 1st bgrd main def 
;RO = MDB 1st row page ptr . 
:R2 is count of main defs 


smain def loop point 


s1st row is Top Row 


;cursor in Ist visible col 
scursor on first row 
sset FAT bit 


sfill char is blank 


zscanline count for top visible 


snext main def ist row page 





8I-d 


: ‘Initialize Window Definition blocks 


MOV 
MOV. 


P2,#WndWDBO.SR.PAGE 
R2,#2 


InitWndDefBlk: 


MOV 
MOV 


MOVX- 


INC 
INC 
MOV 
MOVX 
INC 
MOV 
MOVX 
INC 
“INC 
INC 
MOV 
MOVX 
INC 
MOV 
MOVX 
INC 
MOV 
MOVX 
INC 
MOV 
MOVX 
INC 
MOV 
MOVX 
INC 
MOV 
MOVX 
MOV 
MOV 
DJNZ 


RO, #WndWDBO.AN.OFST 
A, #080H 

aRO,A 

RO 

RO 

A, #WndRCB7.SR.PAGE 
aRO,A | 

RO 

A, #WndRCB7.AN.OFST 
@RO,A 

RO 

RO- 

RO. 

A, #TrmWDB.SR.PAGE 
@RO,A 

RO 

A, #TrmWDB.AN.OFST 
@aRO,A : 
RO 

A, #6 

ar0,A 

RO - 

A, #12 

aRO,A 

RO 

A, #29 

@RO,A 

RO 

A, #68 — 


-@RO,A 


RO, #WndWDB1.AN.OFST 
P2, #WndwWDB1.SR.PAGE 
R2, InitWndDefBlk 


> Initialize the Message Window Definition Block 


7P2 = window def page MOV 
sR2 = window def count MOV 
;window def loop point MOV 
sscroll window flag -  MOVX 
INC 

_INC 

INC 

ING 

spage of first row MOV 
MOVX 

: INC 
soffset of first row ~ . ) MOV 
MOVX 

INC 

MOV 

MOVX 

;page of term wind def _ INC 
MOV 

| MOVX 

offset of term wind def INC 
. : CLR 

MOVX 

swindow begins in row 6 INC 
. MOV 
MOVX 
window ends in row 12 


swindow begins in column 29 ~ MOV 


Window ends in column 68 


zready for next def block 


P2,#MsgWDB.SR.PAGE 


-RO,#MsgWDB.AN.OFST+WDB RowPag 


A, #MsgRCB.SR.PAGE : 
@RO,A | 
RO 

RO 

RO 

RO 

A, #TrmWDB.SR.PAGE 
@RO,A 

RO 

A, #TrmWDB.AN.OFST 
@RO,A 

RO 

A, #24 

@RO,A 

RO 


“A, #24 


a@RO,A 
RO 
A 


@RO,A 


RO 
A, #128 
aRO,A 


P2,#TrmWDB.SR.PAGE 

RO, #TrmWDB.AN.OFST+WDB_RowPag 
A, TrmRow . 
@RO,A 

RO 

A, TrmOf f 

@RO,A | 

RO, #TrmWDB.AN.OFST+WDB_BgnRow 
A, #24 

@aRO,A 


7P2 is page of msg wnd block 
7Set row page (offset is 0) 


next window is term wind 
galso set term seas 
smsg begins at row 24 | 
ie ends at row 24 


smsg starts in col 0 


msg ends in column 80 


- Initialize Termination Window Definition Block 


3P2 = page of term wind block 
;Its row is the term row 


; Start and end on bottom row 
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‘INC RO MOVX 
MOV A, #24 . INC 
MOVX @RO,A | . MOV 
INC RO MOV 
MOV A, #0 ae ANL 
MOVX @RO,A SWAP 
INC RO : RL 
MOV A, #131 | ORL 
MOVX @RO,A MOVX 
; INC 
; Initialize the Row Redefinition blocks (one normal, 15 for font loading) MOV ;double height and underline 
MOVX 
“MOV P2,#NrmRRB.SR.PAGE start with the normal one ~INC 
MOV RO,#NrmRRB.AN.OFST , "MOV 
MOV R2,#00FH rcursor start, end MOVX 
MOV R1,#16 316 redef blocks total INC 
InitRdfBlk: ; 3 - INC 
MOV A,#034H — sscan line, char start and end - CUNE R1,#16,IRB1 
MOVX @RO,A . | My 
INC RO ; MOV P2,#FntRRBO.SR.PAGE sswitch to font redefs 
MOV A,#04DH- tit MOV” R2,#0 sno cursor 
MOVX a@RO,A IRB1: 
INC RO MOV RO, #FntRRBO.AN.OFST soffset of font redef 
MOV A,#000H srow attr, super start and end DJNZ R1, InitRdfBlk ' scontinue with font redefs 
MOVX @RO,A | | | | 3 | | | : 
INC RO. + Initialize 8052 Registers 
MOV A,#00DH . 
MOVX @RO,A ; MOV R1,#TOPHrdLoInd ;Top of Page Hard points to 
INC RO : MOV R2,#BgdMDBO.SR.PAGE ~ : main definition 
MOV A,#000H row attr, sub start and end MOV R3,#BgdMDBO.AN.OFST 
,MOVX @RO,A | LCALL WrAm8052Reg 
INC RO o MOV R1,#TOWHrdLoInd | _7Top of Window Hard points to 
MOV. A, #08DH . 3 MOV _ R2,#TrmWDB.SR.PAGE ; termination window 
MOVX @RO,A ; as MOV _R3, #TrmWDB.AN.OFST 
INC RO | LCALL WrAm8052Reg 
MOV A,R2 : s;cursor start, end (5 bits ea.) MOV R1,#ModReg! Ind ;Mode register 1 
ANL A, #0F8H | - MOV R2,#0C8H 
RR OA  s — MOV R3,#001H 
RR A ; LCALL WrAm8052Reg 
RR. A oa MOV R1,#ModReg2Ind :Mode register 2 





-0z-a 


‘MOV 
MOV 


R2,#016H a 
R3,#0D2H 


LCALL WrAm8052Reg 


MOV" 
MOV 
MOV 

IFO: 
CLR 
MOVC 
MOV 
MOV 
CLR 

"INC 
INC 
MOVC 
MOV 
CLR 
INC 

"INC 
MOVC 
JZ 


| : Now ready to enable interrupts and load font 


IE, #097H 


DPTR, #Fnt_5x7 


DisStt,#1 


A 
A, @A+DPTR 
RO, #PrmBuf 


@RO,A 


A. 
DPTR 
RO 


A, QA+DPTR 


“@RO,A 


A 

DPTR 

RO - 
A, @A+DPTR 
IF2 — 


DPTR 
R2,A 


-: 
A, @A+DPTR 
DPTR 
aRO,A 

RO 


R2,1F1 


A;RO 

c 

A, #PrmBuf 
Prmcnt,A 
DPH 


senable interrupts 
point to 5x7 font 


; and set up to-load it 


initialize font ram 


each character font in turn is 
loaded into the char gen 


PUSH DPL 
MOV A,DisStt 
LCALL WrFntCel 
POP ODPL 
POP DPH 
SJMP IFO 


IF2: 
MOV A,DisStt 
JZ C_Int1 


MOV DPTR,#Fnt_7x9 
MOV DisStt,#0 
SJMP IFO 


C Inti: | 
LCALL ShwCsr 
CLR HstRcvBsyFlg 
LUMP DisCon 


. 


Indicate font type being loaded 
and write to one cell 


; Finished loading a font 
Check font that was just loaded 
Jump if just finished 7x9 


Point to 7x9 font and 
.set up to load it 
Go load font 


smake cursor visible 
sready for host data 
swait for host data 


SEEEEEELEEEEEE EEE EAE EE EEE TEEPE EEE EEE EE EEE EEE EE EEE TEE EERE EEE EEE EE EEE EEE EEE 


; end of C_Init 
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"g051" 


TITLE " - CALEB 0.00 Dispatch Control" 
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C_ Switch _ CALEB 0.00 


Copyright 1985 Advanced Micro Devices, Inc... 
C 


This file contains the central input stream decoder and control dispatcher. 
It is a simple state machine which parses single characters (graphics and 
controls), escape sequences and control ‘sequences. These types of controls 
are defined in ANSI X3.4-1977, ANSI X3.41-1974 and ANSI X3.64-1979 documents. 
The parameters included in control sequences are also decoded and stored as 
a sequence of 8-bit unsigned binary values. 


NAME "Dispatch Control" 
PROG . 


SHEEEE EEE E EEE E REET EEE EEE EEE EE EE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EE 


GLB DisCon 

GLB =: UnI mpCtl 

GLB Escape 

GLB =CtlSeqIntro 

GLB PutMap0 

GLB PutMap1 
PutChr 


Dispatch control procedure 
Unimplemented control (common) « 
Escape 

Control Sequence Introducer 

Checks for font remaping of lower 32 
Checks for font remaping of 3FH & OBFH 
Write cell address and attribute, 


=e ™=s =a =e =e =e 6s 


LoDirChrTbl ,HiDirChrTbl ,DirEscSeqIbl,X3_64DirSeqibl ; in C_Tables 
“EXT = ScrollLeft,ScrollRight - z in C_ Work ~ 
EXT PlcCsr 7 in CUtil_ 


Sf 


SEEEEEEE EEE EEE EE EEE EEE EEE EERE EEE EEE EEE EEE EEE EEE E EERE EEE EEE EEE EEE EEE EEE 


SKIP 
INCLUDE C_MemMap 


SKIP 


SEREEEEE EEL EEE EE EL EEE EEF ERE TEE EEE EEE EEE EEE EEE EEE EEE EE ETE E EEF EF ETE ttt ttt tt ttt 


DirChrSttHdl: 


; Handles all direct character graphics and controls. It uses two, 128-entry 

; tables, indexed by the received character, to dispatch control quickly. 

: 

; NOTE: THIS PART OF THE PROCEDURE MUST BE LOCATED DIRECTLY BEFORE "DisCon". 

Use the character as an index 

Save for use in- repeat case 

High bit selects table (and is 
cleared in the process) 

Select low table (00-7F) and 
go use it 


MOV A,R2 
MOV PrmBuf,A 
JBC ACC.7,DCSH1 


MOV DPTR, #LoDirChrTbl 
‘SUMP DCSH2 


‘me ms ™e Mt mM le 


DCSH1: 
MOV DPTR, #HiDirChrTbl Select high table (80-FF) 
DCSH2: oo 

LCALL DoWrk General address table handler 


NOTE: Instead of jumping back to "DisCon", this part of the procedure is 
located directly before it; therefore, we can simply fall through. 


DisCon: : Dispatch control procedure 


; Waits for a character to be available in the host reception buffer then 
3; extracts it and processes it according to the current state. 

MOV DPH, #HstRcvBuf .SR.PAGE : Address (page and 

DPL,HstRcvExtOff - i; offset) of next character 

3; Idle while waiting for a character 
Check number of chars in buffer 
Loop if none 
Get character from buffer 

and keep it safe - 
Reduce buffer contents count 
Check for 

nearly empty buffer 
Jump if still plenty to do 
Ready to accept more 


: A, HstRcevCnt 
DC1 
A, @DPTR 
R2,A 
HstRevCnt 
A, #NEAR_EMPTY_CNT 
A, HstRcvCnt 
DCc2 . ; 
HstRcvBsyFlg 


me =e =e =e bi) =a =a @s =e 
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as =e =e =e =e =e me 


A, HstRcevExtOff 
A 
DC3 


A, #HstRcvBuf .AN.OFST 


" HstRevExtOff,A 
A,DisStt 
DirChrsttHdl 
Cc. 
DPTR, #SttJmpTbl 
@A+DPTR 


SttJmpTbl : 


_o. 
po 
m 


through this table. 


DirChrsSttHdl 
BgnEscSttHdl 
ExtEscSttHdl 

~ BgnCSISttHdl . 
PrmcSISttHdl 

- ExtCSistthdl . 
Uninpesisethal 


BgnEscSttHdl: 


- 


Pointer to next character 
advanced 

Jump if still in buffer 

Reset to start if went past end 


=e =e =e me 


Keep new next char pointer 
‘Get current state 
_ and jump directly if direct 
Clear carry for other parts 
Use jump table to continue with 
correct part of procedure 


This jump table and the state constants defined in "C_MemMap" must: 
correspond. The state constants represent offsets into this table 
rather than indices (i.e. they increase by three's, not by one's). 


The first entry in the table is for’direct character state, 
as it must be to ensure proper offsets for the other jumps, 
but direct state is always handled specially rather than 


Direct character state 

Beginning escape state 

Extended escape state 

Beginning control sequence state 
Parameter string (in ctl seq) state 
Extended control sequence state 
Unimplemented control sequence state 


Processes the character immediately following an ESC. It may be a final 
character, in which case the corresponding control routine is executed 
using the direct escape sequence table. 
encountered then the state changes to handle extended escape sequences. 
An invalid character ends the escape sequence and causes both characters: 
(this one and the ESC) to be disregarded; the state is set back to handle 
direct characters and-controls. 


If an intermediate character is 


=e =e =e =a =e =e =e =a =e =a =e 


A 
-CtlPtrHi,A- 
CtlPtrLo,A 

BESH4 


A,#C'O!-! 1) 

BESH3 
DisStt,#EXT_ESC STT 
DisCon 


R7,A 

A, #(DEL-'0"') 
BESH1 

A,R7 


DPTR, #DirEscSeqTbl 


DoWrk 


DisStt,#D0IR_CHR_STT 
DisCon 


ExtEscSttHdl: 


A,R2 
A,# 
EESH1 


the appropriate table. 


Get character and check 
for a CO control character 
Jump if not a control char 


; Invalid escape sequence 


r me @e we Me 


=a me =e me 


Check 
’ 
l 


s 
, 
s 
# 


s 
’ 
) 
f 
. 
as 





Clear 
controt routine address 
(makes it unrepeatable) 
Finish escape sequence 
for intermediate character 
Reduce by intermediate range _ 
Jump if not an intermediate — 
Set state for extended escape 
sequences and continue — 
for final character 
Save index temporarily 
Check for invalid character 
Jump if invalid sequence 
Restore control routine index 
Use direct escape sequence | 
table and do control routine — 
eted escape sequence 
Set state for’single, direct 
characters and continue 


Processes the characters in an extended escape sequence. Currently, no 
such controls are implemented, so this part. only passes over intermediates 
until either a final character. or an invalid.character is encountered. At: 
that time. the state is set back to handle direct characters and controls. 


NOTE: Further implementations could be accomplished with the addition of 
other tables of control routine addresses. When a final character 
is found, the corresponding control routine would be executed using - 

Which table is appropriate would depend on 

the sequence of- intermediate characters, which could be interpreted 

by changing to additional: states, or using another state variable: 


Get character and check 
for a CO control character 
Jump if it is a control char 


€c-d 


A,#C'O'-!' y 
EESH2 


A 

CtlPtrHi,A 
CtlPtrLo,A 
DisStt,#DIR_CHR_STT. 


DisCon 


BgnCSISttHdl: 


. 
f 
* 
a 
. 
ag 
e 
’ 
. 
f 
. 
g 
e 
f 
. 
’ 
« 
f 
. 
4 
. 
’ 


MOV 
SUBB 
JNC 


_BCSH1: 


CLR 
MOV 
MOV - 

LUMP 

BCSH2: 
SUBB 
JNC 
CUNE 
CLR 
"MOV 
MOV 

“CLR 
MOV 
LUMP 


parameter accumulation. 
the CSI as well. 


also indicates a null parameter. 


A,R2 
A,#' ! 
BCSH2 


“A 


CtlPtrHi,A 
CtiPtrlo,A. - 
BCSH13 


A,#C'O!-! ') 


“BCSH4 - 


R2,#* *,BCSH3 
PrmBadF lg 

PrmPvt ,.#0 

PrmCnt , #0 

PrmMaxF lg 
DisStt,#EXT_CSI_STT 
DisCon 


s 
’ 
. 


Reduce by intermediate range 
Jump if it is an intermediate 


; Completed escape sequence 


a 
f 
. 
f 
. 
gs 
e 
a 


. 
a 


a’ 
- Inval 
; 
7 
’ 


e 
’ 


‘Clear — 
control routine address 
(makes it unrepeatable) 
Set state for direct chars 


Continue 


Processes the character immediately following a Control Sequence Introducer, 
whether the CSI is a single, 8-bit character or an "ESC [" escape sequence. 
It may be a final character, in which case the corresponding control routine 
is executed using the X3.64 direct sequence table, with the parameter state 
indicating a nul L parameter string. If an intermediate is encountered then 
the state is changed to handle extended control sequences, if it is a space, 
and unimplemented control sequences for any other intermediate. This case | 
Any parameter character is decoded and 
changes state to decode the rest of the parameter string after initializing 
An invalid character ends the sequence and discards 


- Get character and check 


for a CO control character 


; Jump if not a control character 


id sequence 
Clear 
_ control routine address 
(makes it unrepeatable) — 
Finish sequence 


; Check for intermediate character 


e 
a 
. 
’ 
s 
g 
e 
’ 
s 
& 
. 
a 
s 
a 
. 
a 


,Reduce by intermediate range: 
‘Jump if not an intermediate 
Jump if unimplemented 
Indicate no error 
not a private parameter, 
null parameter string, and 
not too many 
Change state for extended CSI 
sequences and continue 


BCSH3: 
MOV 
LJMP 

BCSH4: 
SUBB 
JNC 
ADD 
JC 

~ MOV 
ADD 
MOV 
SETB 

BCSH5: 
MOV 
LJMP 

BCSH6: 
CJNE 
CLR 

BCSH7: 
MOV 

-MOV 
MOV 
BCSH8: 
MOV 
CLR 
CLR 
SJMP 

BCSH9: 
CJNE 
SETB 
SJMP 

BCSH10: 

~ CLR 
MOV 
MOV 
SJMP 

BCSH11: 
MOV 
SUBB 
JNC 
CJUNE 


_DisStt,#UNIMP CSI STT 


DisCon 


A,#('a'-'0') 
BCSH11 
A,#C'2#-"98) 
BCSH6 
PrmPvt, #0 

A, #10 
PrmAcc,A 
PrmBgnF lg 


DisStt,#PRM_CSI_STT 
DisCon 


R2,#':',BCSH9 
PrmBadFlg 


PrmPvt, #0 
PrmCnt, #1 
PrmBuf., #0 


PrmAcc, #0 


PrmBgnF lg 


PrmMaxFlg 
BCSH5 


R2,#':"',BCSH10 
PrmBadFlg 
BCSH7 


PrmBadF lg 
PrmPvt ,R2 
PrmCnt , #0 
BCSH8 


R7,A 
A, #(DEL-'a") 


-BCSH1 


R2.#'b', BCSH12, 


Unimplemented intermediate characters 


’ 


’ 


Set state for unimplemented 
CSI sequences and continue 


Check for parameter character 


. 
g 
e 
g 
.s 
a 
e 
td 
s 
a 
. 
& 
2 
a 
e 


Reduce by parameter range 
Jump if not a parameter 
Check for special param char 
Jump if not a digit parameter 
Indicate not private params 
Readjust decoded param digit 
and start accumulator 
Indicate start of param string 


Peform parameter decoding 


° 
f 
. 


a 


Change state to decode CSI 
parameters and continue 


Special parameters 


e 
s 
e 


a 


Jump if not good separator 
Indicate no errors if good 


Initial default parameter 


. 
ri 
2 
’ 
a 
a 


Indicate not private params 
One parameter so far and 
it is zero (default) 


up for parameter accumulation 


« 
af 
. 
a 

. 
rd 
= 


’ 


Clear accumulator 

Indicate start of parameter 
string and not too many 

Continue with new state 


Special parameters (not semi-colon) 


Jump if not unused separator 
Indicate an error if found 
Treat as initial default 


Special private parameters 


we @e Me fe 


=e mae =a =e 


Indicate no error and. 

save special parameter 
Indicate empty param buffer 
Get ready to accumulate params 
for final character 
Save index temporarily 


Check for invalid character 


Jump if invalid sequence 
Jump if not REP sequence 





2-C 


MOV. 
LCALL 
SJMP 


BCSH12: 


CLR 
MOV - 
- MOV 
~ CLR 
MOV 
MOV 
LCALL 
BCSH13: 
MOV 


. 
J 
’ 
° 
a 
. 
’ 
° 
a 
. 
a 


~ MOV 
SUBB 
JNC 


PCSH1: 
CLR 
MOV 

MOV 
SJMP 

PCSH2: 
SUBB 
JNC 
CJNE 
MOV 
JNB 

- MOV 
SUMP 


is encountered. 
routine is executed using the X3.64 direct sequence table. 
changes state to handle extended control sequences, if it is a space, and to 
unimplemented control sequences for any other intermediate. 
character ends the sequence and discards the entife control sequence. 


~ PCSH2 


PCSH5 


PrmRep, #1 
Repeat 
BCSH13 _- : 5 8 ; 


Set default parameter and do 
special repeat (if* possible) 
Finish sequence oe 


; Normal final. character 


PrmBadFlg © 
PrmPvt,#0 | 
PrmCnt , #0 


 PrmMaxF lg 


- DPTR, #X3_64DirSeqTbl 


A,R7 - Pt 
DoWrk ’ 
l 


Indicate no error 
not a private parameter, 


null parameter string, and — 


not too many 
Restore control routine index 
Use CSI direct sequence table 
~ and do the control routine 


; Completed CSI sequence 


DisStt,#DIR_CHR_STT 
DisCon 


PrmCSISttHdl : 


A,R2 


; 
A,#! a ~~ ; 
i 


Set state for single, direct 
characters and continue 


Decodes the parameters in a control sequence until a non-parameter character 
If it is a final character then the corresponding control 


An intermediate 


An invalid 


Get character and check 
for a CO control character 


> Jump if not a control character . 


‘Invalid control sequence 


A 


ctlPtrLo,A 
PCSH12 


 ctlptrhi,A | . ; 
: 


. ; Check 
A,#C'O!-! t) 
PCSH4 
R2,#!' ',PCSH3 
DisStt,#EXT_CSI_STT 
PrmBgnFlg,PCSHS 
PrmCnt , #0 


me we =e us =e “ue =. 


Clear 
control routine address 
(makes it unrepeatable) 
Finish sequence 
for intermediate character 
Reduce by intermediate range 
Jump if not an intermediate 
Jump if unimplemented 
Set state for extended CSI seqs 
Jump if not first parameter — 
initialize param cnt 
Go handle parameter 


PCSH3: 
_MOV 
SJMP 


PCSH4: ~ 
SUBB 
JNC 
ADD 
JNC 
CJUNE 

PCSH5: 

~ ECALL 
LUMP 


PCSH6: 


SETB 
-SJMP 
PCSH7: 
ADD 
MOV 
MOV 
MOV 
MUL 
JB 
ADD 
JC 
MOV 


LUMP — 


PCSH8: 
MOV 
LUMP 

PCSH9: 

MOV 
SUBB 
JNC 
CUNE 

“MOV 
-LCALL 
SUMP 

PCSH10: 
LCALL 
MOV 
MOV 
LCALL 


DisStt,#UNIMP_| CSI _STT 
PCSHS 


A,#(''-"0!) > 
PCSH9 


A, #C'2*- 198) 


PCSH7 
R2,#'s', PCSH6 


SavPrm 
DisCon 


PrmBadF lg . 
PCSH5 


A, #10 
R7,A 
B,#10 
A,PrmAcc 
AB 
OV,PCSH8 
A,R7 
PCSH8 
PrmAcc,A 
DisCon 


PrmAcc , #255 
DisCon 


R7,A 

A, #(DEL-'a') 
PCSH1 

R2,#'"b', PCSH10 
PrmRep, PrmAcc 
Repeat 

PCSH12 


SavPrm 


“A,R7 


DPTR,#X3_64DirSeqTbl 


-DoWrk 


; Unimplemented intermediate characters 
: Set state for unimplemented 
: CsI soquence: and continue 


; Check for parameter character 
; Reduce by parameter range 
; Jump if not a parameter 
: Check for special param char 
; Jump if a digit parameter — 
: Jump if not a valid separator 
: Parameter separator _ 
: Save latest parameter 
: and continue - 
: Invalid special parameter - character 
; Signal bad parameters . 
; Treat as a separator & continue 
+ Parameter digit . 
Readjust decoded param digit 
and save it temporarily 
Multiply (by 10) 
current parameter value 
‘to account for another digit 
Jump if param greater than 255 
‘Accumulate latest digit 
Jump if param greater than 255 
Save accumulated param value 
and continue - 
: Parameter too large 
Save largest possible value 
and continue a S 


=e ™e Ss &@s Ss Sse MO Be BH BE 


- 3 Check for final character 


Save index temporarily 
Check for invalid character 
Jump if invalid sequence -— 
Jump if not REP sequence 


™a =a =. =e 


; Do special repeat Cif possible) 
: Finish sequence | 
: Normal final character © 
Save latest parameter 
Restore control routine index 
Use CSI direct sequence table 
"and do the control routine = 


=e 8 =e %s 





¢é-d 


PCSH12: / - ; Completed CSI sequence 


‘Set state for single, direct 
-characters and continue 


MOV DisStt,#DIR_CHR_STT 
LUMP DisCon 


ExtCSISttHdl: 


=e =a =e %e =e 8 =. =e =e ue 


=e =e ™e =e 


‘NOTE: 


Processes the character immediately following the first space intermediate 
in a control sequence; no other intermediates are implemented. It does a 
special check for the two acceptable final characters which are implemented 
and executes their control routines directly if found. Any other valid final 
character or, an invalid character ends the sequence with the entire sequence 
being discarded. If an intermediate character is encountered then the state 
is changed to handle unimplemented control sequences. 


Further implementations could be accomplished with the addition of 
other tables of control routine addresses. When a finat character 
is found, the corresponding control routine would be executed using 
the appropriate table. Which table is appropriate would depend on 
the sequence of intermediate characters, which could be interpreted 
by changing to additional states, or using another state variable. 


R2,#'@' ,ECSH1 : Jump if not SL final character 
ScrollLeft = 3; Do scroll left control then 
ECSH4 . continue with direct state 


R2,#'A', ECSH2 ; Jump if not SR final character 
ScrollRight ; Do scroll right control then 
ECSH4 ; continue with direct state 
; Unimplemented or invalid character 
-°'s Get character and check 
for a CO control character 
’ Jump if it is a control char 
Reduce by intermediate range 
Jump if not an intermediate 
Change state for unimplemented 
CSI sequences and continue 
id CSI sequence : 
Clear 
control routine address 
(makes’ it unrepeatable) 


A,R2 
A,#! 4 
ECSH3 

A,#¢'0!-! ') 
ECSH3 
DisStt,#UNIMP_CSI_STT 
DisCon 


=e use =e 


~~ ws Se Be we 


; Inva 
A. : 
CtlPtrHi,A : 
CtlPtrLo,A : 


ECSH4: . ; Completed extended CSI sequence 


MOV DisStt,#DIR_CHR_STT 
LUMP DisCon 


Set state for single, direct 
characters and continue 


e 
f 
s 
’ 


UnImpCsISttHdl : 


° 
a 
s 
’ 
. 
a 
s 
& 
. 
s 
s 
g 
e 
& 
s 
a 
. 
a 
. 
f 


Processes unimplemented CSI sequences with intermediate characters by passing 
over intermediates until either a final character or an invalid character is 
encountered. It then changes the state back to handle direct characters. 


Further implementations could be accomplished with the addition of 
other tables of control routine addresses. When a final character 
is found, the corresponding control routine would be executed using 
the appropriate table. Which table is appropriate would depend on 
the sequence of intermediate characters, which could be interpreted 
by changing to additional states, or using another state variable. 


: Get character and check 
for a CO control character 
; Jump if it is a control char 
Reduce by intermediate range 
Jump if it is an intermediate . 


A,R2 
A,#' ! 
JC UCSHT 
A,#C'O!-5 ty) 
JC —_—-UCSH2 


UCSH1: :; Completed CSI sequence 


Clear 
control routine address 
' (makes it unrepeatable) 
Set state for direct characters 


CLR A : 
MOV CtlPtrHi,A ; 
MOV CtlPtrLo,A : 
MOV DisStt,#DIR_CHR_STT : 


UCSH2: 


LJMP DisCon ; : Continue 


SEEEEEEELELEEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EE EEE E EEE TEETH TEE TTT F tt ttt tt ttt ttt tt tt 


SavPrm: 


ba a i ee ee | 


Saves the current contents of the parameter accumulator in the parameter 
buffer and increments the parameter count, provided the parameter buffer 
is not full. If this is a first parameter then the parameter accumulator - 
is saved as the special repeat parameter; otherwise, the special repeat 
parameter is checked and, if present (i.e. this is the second parameter), 
it is saved before the parameter accumulator and then cleared. Finally, 
the parameter buffer is checked to see if it has become full. 


10 





9¢-d 






e 


: Bad: 






JB 
JNB 
MOV 
SPI: 
CLR - 
Mov 
CJUNE 
SETB 
~ SUMP 
SP3: 
MOV 
ADD - 
MOV 
MOV 
INC 
SP4: ° 
MOV 
RET 


DoWrk: 


In: 


. 
r 
. 
fs 
e 
f 
. 
a 
se 
a 


A,RO 


PrmMaxFlg,SP3 
PrmBgnFlg,SP1 
Prmcnt , #0 


PrmBgnF lg 
A,Prmcnt © 


A,#PRM_CNT_MAX,SP3 


PrmMaxFlg 
SP4 


A, #PrmBuf 
A,Prmcnt . 
RO,A 

@RO, PrmAcc 
PrmCnt 


PrmAcc,#0 . 


A 
DPTR 


RO,CtlPtrii 
R1,CtlPtrlo 
A 

R7,A 


- A, @A+DPTR 


CtlPtrHi,A 
A,R7 

A 

A, @A+DPTR 
CtlPtrLlo,A 
DPH,CtlPtrHi: 
DPL,A 


=e ms =e me 


Jump if param buffer is full 


Check count and 
jump .if maximum not reached 
Indicate full if max is reached 
and discard parameter 


Reset for more parameters 


Get 


‘ This routine falls through to the next 
; 11 


e 
ag 
s 
a 
. 
s 
° 
e 
e 
f 


Point into parameter buffer 
at location where next 
parameter is to be stored 

Store latest parameter 

Account for latest parameter 


ready for next parameter 


. 
f 
. 
a 


control 
base of 


2 
t 
s 
a 
e 
g 
s 
a 
s 
f 
s 
f 
. 
’ 
s 
g 
. 
f 
2 
’ 
e 
a 
se 
a 


Clear parameter accumulator 
and exit 


og 


FEEEEEEE EAE E EEE E EEE E EEE E EEE E EET TET E EEE E EEE E ETE TEE T Ett Et tt PTET ttt Pett ttt ttt 


Transfers control to the subroutine ‘indicated by the index into the given 
address table. The address is also saved for 


possible repetition. 


routine index 
control routine address table 


Save previous control routine 
so ESC and CSI can restore 
Turn index into offset into tbl 
and save it temporarily 

Get high byte of address and 
save it 

Restore offset and 
adjust for next location 

Get low byte of address and 
save it 

Set indirect pointer's high and 
tow bytes — : 









DoIndRtn: © 






Provides an entrypoint for indirect subroutine calls. . & 































7 ' 
eis DPTR address of indirect subroutine - 
: (and whatever the indirect subroutine needs) 
; Out: (whatever the indirect subroutine returns) 
3; Bad: A (and whatever the indirect subroutine affects) 
: ; , 
; NOTE:. This may not be used to call a subroutine which. requires either 
P 






May 


cs the accumulator (A) or the data pointer (DPTR) as input. 





CLR A 7 Clear indirect-.offset and 
JMP @A+DPTR : : transfer control 

















SEEEEEAL ELE EEF EAE EEE ELEE ELE FEES ESE AS ES EF EEE EEE EEE EE DET EEE E FETE EEE ttt ttt ttt ttt 


UnImpCtl: 4 f 






; Catch all for unimplemented controls. 


' 


















CLR A » Clear 

MOV CtlPtrHi,A ; control routine address _ 
MOV CtLPtrLo,A ; (makes it unrepeatable) _ 
RET . and exit ; 














SHEEELELEELEL ESE EES EEE EEE EEE EEE EEE EEE E EEE EE EE EEE EEE E EEE TEETH EEE TE Ett ttt t ttt 


Escape: 





Control routine for ESC control character--changes state to handle escape 





: 
7; sequences. - 












MOV CtlPtrHi,RO ; Restore previous 

MOV CtlPtrLo,R1 : control routine pointer 

MOV DisStt,#BGN ESC STT ; Set state for escape sequences . 
RET | | ; and exit 





TERETE AEEL ESE ELLE FEET EEE SEES EEE EEE EEE EE EEE EE EEE EEE EEE EEE E TEE EET E Ett ttt ttt tt 







CtlSeqintro: 









r 


Control routine for CSI control character or escape sequence- - changes state. 
to handle control sequences. 






. 
# 
. 
f 






Lcé-ad 


SEEEEEELEL EL EEELE EEE EEE EEE EE EEE TELE EET EEE EEE EEE EEE EE EE EEE EEE EE EEE EEE EEE EEE Ett 


MOV CtLPtrHi,RO j Restore previous 

MOV CtlPtrLo,R1 ; control routine pointer 
MOV | DisStt,#BGN_CSI_STT : ; Set state for CSI sequences 
DEC SP ; Remove return address 

DEC SP : : from stack and 

LJMP DisCon : . continue 


PutMap1: 


~ 
a 


JNB = FntMapFig, PutChr 
MOV A, PrmBuf 

ADD A, #040H 

SJMP PCO 


va 


SEEEEEEEEE EEE EEE FELT EEE EEE AEEE EEE EEE EEE EEE EEE ET EEE EEE EE EEEE EEE EEE FEE ttt tt 
PutMap0: 


® 
e 


JNB- FntMapFlg,PutChr 


MOV A,PrmBuf 


CLR C 


~ SUBB A, #040H 
SUMP PCO 


SEEEEEEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE E TEE ET ESTE ETE TEEPE ET EEE EET Eth tt ttt tt tet 


=s Se we Se Be BO 


PutChr: 


Writes a character generator cell address and the current attribute to the 
appropriate locations in display memory indicated by the active position. 


It advances the active position provided it is not at the rightmost column. 
The cursor position is also updated using the cursor zone information. 


= 
Zz 


PrmBuf. . re cell address (i.e. character code) 


A, PrmBuf - .  ¢ Get the unmapped character code 


; Common character placement entrypoint 
Save cell address 
Page of active. row and 


R2,A : 
; 
- offset to base of characters 
’ 
’ 


P2,CurRow 
A, Chroff 
A,ActCol 
RO,A- 


Add active column to determine 
offset for location to write 


A,R2 


~ @RO,A 


A, Atroff 

A, ActCol 

A, ActCol 

A 

RO,A 
WndActFlg,PC1 
P2.4 

PC2 


P2.5 


A,CurAtr 

@RO,A 

P2,#MsgActCnt .SR.PAGE 
MsgActFlg,PC3 
A, #MsgActCnt .AN.OFST 
PC5 


WndActFlg,PC4 

A, CurRow 

A, #00FH 

A, #WndActCntBuf .AN.OFST 
PC5 


A, CurRow 
A,#01FH 
A, #BgdActCntBuf .AN.OFST 


RO,A 
A,@RO 
ActCol 
A,ActCol 
A, ActCol 
PC6 


aRO,A 


WndActFlg,PC7 
A,#40,PC8 
ActCol 


Get cell address and 

write it to display memory 
Offset to base of attributes 
Add active column 

twice and 

adjust for attribute byte to 

get offset for loc to write 
Jump if window disp not active 
Adjust page for window display 

and go on 


=e me =e =e =a =e =e =e =o =e 


* Adjust page for bgd/msg display 
current attribute 
Get current attribute and 

write it 
Page containing active counts 
Jump if message disp not active 
- Offset of message active count 
and go use it 


=e me we we 


~ 


=e 


Jump if window disp not active 
: Page of current row converted - 
to physical number and 
_ added to base of window 
active count buffer 


Page of current row converted 
to physical number and added 
to base of bgd act cnt buf 

; Update active count 
; Offset of this row's active cnt 
; Get current active count, . 
; new active count and 
: compare them 
; Get new active colum for later 
; Jump if old active cnt is OK 
3; Write new active cnt if greater 
k for end of row (rightmost col) 
Jump if window disp not active 
Jump if not at right of window 
Restore active column if at end 
and exit 


Chec 


=e Se Be we 





PC7: 
CJNE 
DEC 
RET 

PC8: 
DJNZ 


yc LCALL 


A,#128,PC8 . 
ActCol . 


CsrZonCnt,PC9 - 
PlcCsr 


Jump if not at right of bgd/msg 


7 
-— Restore active column if at end 


re and exit 


3; Advance cursor location 


Jump if still in same zone 
Place cursor in new zone 


Rp3: 
RET 


A. 


CtlPtrhHi,A - 


CtlPtrLo,A 


f 


control routine address. 
(may only be REP'd once) 


> Exit 


-RET ; and exit Za FEEEEELEEEEAEEAEAEREEEEEEEEEEEEEEEEEEEE EEE LEE EE EEE EEE EE EEE EE EEE EE 444444444444 


9z-d 


PC9: ; Speedy update of cursor location. ; End of C Switch 7 


JNB 
MOV 
MOV 
MOVX 
INC 
MOVX 
MOV 
MOVX. 
PC10: 
RET 


CsrZonFlg,PC10 
P2, #BgdMDBO.SR.PAGE 


~ RO, #BgdMDBO.AN.OFST+MDB_Cux 
- A,aRO | 


A 
aro, A 


RO, #BgdMDB1.AN.OFST+MDB_ Cux 


@RO,A 


=s =e ™e me La) mea me use 


Jump if cursor is invisible 
Page of MDBs and 

offset to cursor location 
‘Current location (both MDBs) 
. advanced rightward and 

put back then 

other MDB 

gets same location 


s Exit 


PEEEEEEEE EEE REET EEE EEE EEE EEE EEE EEE E EE ELE EEE EEE EEE EE EEE EE EEE EEE EET Et ttt t ttt 


Repeats: 


=e =e =e =e =e =e mae 


_ JNB 
MOV 
ORL 
JZ 
MOV 
JNZ 
MOV . 

Rp1: 
MOV 
MOV 
LCALL 
— DUNZ 


parameters. 
information has been lost and this sequence is ignored. 


PrmBgnF lg, Rp2 
A,CtlPtrHi 
A,CtlPtrLo 
Rp3 

A,PrmRep 

Rp1 

PrmRep, #1 


DPH, CtlPtrHi 
DPL,CtlPtrLo 
DoIndRtn 

PrmRep,Rp1 . 


Repeats the previous control routine if it is repeatable. The parameter 
decoding part of the state machine is careful to preserve the previous 
‘parameter buffer and provides a.special repeat parameter for this control 
routine, which is checked for and executed directly. ‘This is necessary to 
prevent this control's sequence from interfering with the previous control's 
If the special. repeat parameter is zero then the previous — 


Check previous 
control routine address 
Jump if not repeatable. 


each repetition . 
Get previous control routine 
address into indirect ptr 
Execute the control routine - 
Loop specified number of times 





67-C 


“4go5 1 


“THILE * CALEB 0.00 . Control Tables" 
SEEEEEEE EEE E EEL EE EEE EE ERE EEE EEE EEE EE EEE EEE EEE EEE EEE E EE EE EEE EEE E EEE EEE TEE 


C_Tables | CALEB 0.00 


This file contains the address tables used by the state machine to dispatch 
control to the various control routines. 


’ 
: Copyright 1985 Advanced Micro Devices, Inc. 
’ 


NAME "Control Tables" 
PROG 


: FEEEEEEEE LEAF EEE EE EEE EF EEE EEE EEE EEE EEE EEE EL EEE EEE EEE EEE EEF EE EE EEE ETH Ett tt ttt 
GLB = LoDirChrTbl First 128 entries for direct state 
GLB =HiDirChrTbl Second 128 entries for direct state 
GLB DirEscSeqTbl Non- intermediate escape sequences 

X3_64DirSeqTbl Non- intermediate control sequences 


C Switch 
C_Work 
C_Work 
“C_Work 
C_Work 
C_Work 
C Work 
C Work 
C_Work 
C Work 


UniImpCtl, Escape, CtlSeqintro, PutMap0, PutMap1, PutChr 
Backspace, CarriageReturn, NewL ine 

ResetInitState 

CursorBackward, CursorDown, CursorForward 
CursorPosition,CursorUp, DeleteLine,EraseInDisplay 
EraseInLine, InsertLine,ResetMode, Scrol LDown 
SelGrfRendition, SetMode, Scrol lUp 

CharBl inkRate, LoadFontCell,SelActiveDisp 
SelCursorAppear , SmoothScr lRate, SelWindowVis 
SelMessageVis 


J 


‘ ods ads umd @ amdg 
=) a 


se 


37 3 35 


ba i i i a i | 


anda mis ante okt 


a} 


SEREEELE EERE EEE EEE EE EEE EEE EEE EEE ER EEE EEE EEE EEE EEE EEE EE EEE EEE EEE EEE EE EET E EEE 
SKIP 


SEEEEEEEEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EE EEE EET EE EET T EET TEE E EET 


LoDirChrTbl: ; ; First 128 entries for direct state 


UnImpctl 
Unimpctl 
Unimpctl 
UnImpctl 
UniImpCtl 
UnImpCt lL 
Unimpctl 
UnImpctt 
Backspace 
Unimpct L 
NewL ine 
UnImpCtl 
Unimpctl 


CarriageReturn- 


UnImpctt 
UnImpctl 
Unimpctl 
UnimpCtl 
UnImpCctl 
UnImpctlt 
UnImpctl 
UnImpctl 
UnImpCt L 
UnImpctl 
Unimpctt 
UnimpCtl 
UnImpCt L 
Escape 

Unimpct l 
UnimpCt lt 
UnimpCtt 
UnImpctl 


‘PutChr 


PutChr 
PutChr 
PutChr 
PutChr 
PutChr 


- PutChr 


PutChr 
PutChr 
PutChr 


—=s "@8 Se ese Ss Bs BP Bs BMH BSE Be BB Bh Be We We As WH We WH We We We Be We We Be Be We WH We Ws We We Me We We We We We We WE 
, . 


Null , 
Start of Heading 
Start of Text 

End of Text 

End of Transmission 
Enquiry 

Acknowledge 

Betl 

Backspace 

Horizontal Tabulation. 
Line Feed (New Line) 
Vertical Tabulation 
Form Feed 

Carriage Return 
Shift Out 

Shift In 

Data Link Escape 
Device Control 1 
Device Control 2 
Device Control 3 
Device Control 4 
Negative Acknowledge 
Synchronous Idle 
End of Transmission Block . 
Cancel 

End of Medium 
Substitute 

Escape 

File Separator 

Group Separator 
Record Separator 
Unit Separtor 

Space 

Start of GO Characters 





— 0E-d 


PutChr 
PutChr 
PutChr 
PutChr 


~ putChr - 
- PutChr 


PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 


PutChr - 


PutChr 
PutChr 
PutChr 


' PutChr 
PutChr 


PutChr 
PutChr 


-PutChr 


PutMap1 
PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMap0 


- PutMap0 


PutMap0 
PutMap0 
PutMap0 
PutMap0 


. PutMapO 


PutMap0 
PutMapO 
PutMap0 
PutMap0 
PutMap0 


“PutMap0 
PutMapO . 


PutMap0 


- PutMap0 
_ PutMap0 


=e 6M =e “a =. =e =e S&S =a =e Se =o =s SE =e =e 28 =e Se Se Sea Ss Ba Bs =e =. =e “68 =e 6&8 =e =a =e =e 6% =e =e =e =e =e Oe =e me 


OMANAURWNAON. 


A me 


> . 
2 
a 
A 
B 
C 
D 
E 
F 
G 
H 
I 4 
J 
K 
L 
M 
N 
0 
P 
. 
R 
S) 
T 


PutMap0 


PutMap0 — 


PutMapd 
PutMapo. 


PutMap0 


PutMap0 
PutMap0 
PutMap0 


PutMap0 
PutMap0 


PutMap0 
PutChr 
PutChr 


-PutChr 


PutChr. 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr | 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr - 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 


UnImpct l 


=a5 —s =e =f ,me =a =e =e =e =e. @e us =. =a us = =e =e =. ue es us =e es ma ae me ws mae 


=e =e =e =s 


. =e 


> wee nN KX EK SC 


DEL 


Ym AN MK KX BE KC Ctns31 aA BOD BKK es Tanroanonrwsa 


‘End of GO Characters 


Delete 
k 





Te€-d 


‘” HiDirChrTbl: 


DW 
DW 
DW 

- DW 
DW 
DW 
DW 
DW 


DW 


DW 
DW 


DW 


DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 

DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 


UnImpCt lt 
UnImpCt L 
UnImpct l 
UnImpCtl 
UnImpCtl 
Uni mpCt lt 
UnImpCtl 
Unimpctl 


UnImpCtl 
UnimpCtl 


-UnImpCt l 
‘Unimpct 


UnImpCtl 
UnimpCtl 
UnImpCt | 
UnImpCtl 


UnImpCt l 
UnImpCt t 


UnImpct t 
- Unimpctt 


UnImpCtl 
UnImpCtl 


UnimpCtl © 


UnImpctl 
UnImpCtl 
UnimpCtl 
UnImpCtl 


CtlSeqintro 


UnImpCtl 
UnImpctt 


‘UnImpctt 


UnImpCt 


PutChr | 


PutChr 
PutChr 
PutChr 
PutChr 
PutChr 


s 
f 
es 
e 
s 
# 
. 
f 
s 
ci 
« 
tf 
se 
gf 
s 
ti 
. 
a 
s 
a 
= 
rd 
e 
f 
e 
ti 
e 
ei 
s 
cf 
. 
tf 
. 
’ 
s 
s 
s 
f 
se 
a 
es 
ff 
s 
’ 
» 
Ci 
e 
a 
2 
f 
e 
f 
e 
cf 
s 
f 
. 
# 
= 
a 
es 
f 
s 
a 
a 
az 
. 
a 
s 
f 
e 
a 
s 
f 
e 
f 


: Second 128 entries for direct state 


fut. std. - 
fut. std. 
fut. std. 


fut. std. 


Index 

Next Line 

Start of Select Area 

End of Selected Area 
Horizontal Tabulation Set 
Horizontal Tab with Justify 
Vertical Tabulation Set 
Partial Line Down 

Partial Line Up 

Reverse Index 

Single Shift Two 

Single Shift Three 
Device Control String 
Private Use One 

Private Use Two 


_ Set Transmit State 


Cancel Character 
Message Waiting 

Start of Protected Area 
End of Protected Area 
fut. std. 


- fut. std. 


fut. std. 

Control Sequence Introducer 
String Terminator 

Operating System Command 
Privacy Message 

Application Program Command 


Start of G1 Characters 


PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 


PutChr . 


PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutChr 
PutMap1 


PutMap0 


PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMapO 
PutMap0 
PutMap0 
PutMap0 
PutMap0O 
PutMap0 
PutMapO 
PutMap0 


=e es Se Ss We ia a ll ll ad dd kn nk ed i ed! Ce ee ee ee ee SS a, fe 2] 





ce-d 


PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMap0 
PutMap0 


PutMap0 | 


PutMap0 
PutMap0 
PutMap0 


PutMap0 


PutMap0 
PutMap0 
PutMap0 
PutMap0 
_ PutChr 


PutChr 


PutChr 
PutChr 
PutChr 


~ PutChr 
PutChr — 


PutChr 
PutChr 
PutChr 
PutChr 
PutChr 


~ PutChr 


‘PutChr 
PutChr 
- PutChr 
PutChr 


PutChr — 


PutChr 


PutChr 


PutChr 
PutChr 


PutChr | 


PutChr 
PutChr 
PutChr 


‘ ' ; 
=e =e =e =e es =e =a =e =e, we =e =e Ge me =e me =e =e =e as ue =e =e =e =e |e “Se we =e me 7) =e =s =e =e =e =e es =e ee =. =e 
‘ 


DW 
DW 
“DW 
DW 
DW 
DW 


PutChr 
PutChr 
PutChr 


-PutChr 


PutChr 
UniImpCtl 


; FAH 
; FBH 
; FCH 
; FDH 


- FEH 


FFH 


End of G1 Characters — 


SEER EEEEEEE EEE EEE EE EE EE EEE EEE EEE PTET EEE ET EEE EEE ET TEE EEE EET EP ETE EEE EE Ett 


SKIP 


EERE EEEEEEE EEE EEE EEE EEE ETE EEE EEE ET EEE EEE EET EE EE ETE ET EEE EET E TE TE TFET TEE TET ttt 


DirEscSeqTbl: 


DW 


DW - 


DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
bw 
_ DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 


UnImpctl 


' UnImpctl 


Unimpctl 
UnImpCt l 


UnimpCtl 
‘Unimpctl 


UnImpCtl 
Unimpctl 


~ Uni mpctl 


Unimpctl 
Unimpct lt 
UnImpCtl 


UnimpCtl 
UniImpctl - 


UnImpctl 


_ UnImpcte tl 


UnimpCtl 
Unimpctl 


UnImpctl 


UnImpCt l 
UnImpctl 
UnImpCtl 
UnImpctt 
UnImpCt L 
UnImpCtl 
Unimpctl 
Unimpctl 
UnImpctl 
UnimpCt t 
UniImpctl 
UnImpCt l 
Uni mpCt L 


30H 


; 31H 


“Ss me =e =a ue as =e Me me =. =e ae =e me =e ue me =e =e me me me me me =e =a =a =e =a 


32H 


33H 
34H 
35H 
36H 
37H 
38H 
39H 
3AH 
3BH 
3CH 
3DH 
3EH 
3FH 
40H 
41H 
42H 
43H 
44H 
45H 
46H 
47H 
48H 


49H 


GAH 
4BH 
4CH 
4DH 
4EH 
4FH 


. Non- intermediate escape sequences 
priv. use 
priv. use 
priv. use 
priv. use 
priv. use 
priv. use 
priv.. use 
priv. use 
priv. use 
priv. use 
priv. use 


" priv. use 


priv. use 
priv. use 


“priv. use 


priv. use 
fut. std. 


_ fut. std. 


fut. std. 

fut. std. 

Index 

Next Line 

Start of Select Area 

End of Selected Area 
Horizontal Tabulation Set 
Horizontal Tab with Justify 
Vertical Tabulation Set 
Partial Line Down 


‘Partial Line Up 


Reverse Index 
Single Shift Two 
Single Shift Three 
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7BH fut. std. 
7CH fut. std. 
70H " fut. std. 
7EH fut. std. 


Device Control String DW “UnImpct L 
Private Use One DW =: UnI mpctl 
Private Use Two - DW UnImpctl 
Set Transmit State DW UniImpctl 
Cancel Character 
Message Waiting 
Start of Protected Area - SKIP 

End of Protected Area SERRE EEELE EA EE EEE EEE EEE EEE EEE EE EEE EEE EEF EEE E EEE ET TEE TFET tt ttt TTT ttt ttt ttt tt 
fut. std. . 

fut. std. | X3_64DirSeqTbl: : : Non- intermediate control sequences 
fut. std. 7 : : | 
Control Sequence Introducer . DW Unimpctl 
String Terminator DW CursorUp 
Operating System Command DW CursorDown 
Privacy Message DW CursorForward 
Application Program Command DW CursorBackward 
Disable Manual Input DW UnImpCt l 
Interrupt , ; DW UnImpCt l 
Enable Manual Input DW  —_- UnI mpCt 

Reset to Initial State DW CursorPosition 
fut. std. _ . DW sUnI mpctl 

fut. std. . ' OW EraseInDisplay 
fut. std. DW EraseInLine 
fut. std. | DW InsertLine 


_UnImpCtl 
UnImpctl 
UnImpCtl 
UnImpCctl 
UnImpCt L 
UnImpCtl 
UnImpCt L 
UnImpctl 
UnImpctt © 
UnImpCtl 

“ UniImpctl | 

- CtlSeqIntro 
UnImpCt l- 
UnimpCt 
UnimpCtl - 
UnImpctl 
UnImpCt lt 

_Untmpctl 
UnImpct l 
ResetInitState © 
UnImpctl 
‘UnImpCt | 
‘Unimpctt 
UnImpCt 
UnImpCt 


=e =e Le =e 


SEEELELEEEEEEEELEE EE EDEL EL AE EEE EEE E EEE ET EET E TEE TTT T TTT ttt ttt Ft ttt ttt ttt tt tt ttt 


Insert Character 

Cursor Up 

Cursor Down 

Cursor Forward 

Cursor Backward 

Cursor Next Line 

Cursor Preceding Line 
Cursor Horizontal Absolute 
Cursor Position 

Cursor Horizontal Tabulation 
Erase in Display 

Erase in Line 

Insert Line 

Delete Line 


UnImpCtl 
UnImpCt 


UnimpCtl 
UnImpctl 


UnimpCt L 
UnImpCt L 


Uni mpctl 


UnImpCt l - 
UnImpCtl 
UnImpct L 
UnImpCtl, 
UnImpCtl 
UnImpCt L 
UnImpCctl 
UnImpCtl 
UnImpCtl 


-UnImpCctl 


UnImpCtl 


, ’ \ 
=e =e =e =e =e me =e me =. =e =e =e us =e =e =e =e =e =e as wee =e =e =e ee =e ee =e =e ee ema me =e we =e =e me =e =e we =. we yee 


fut. std. 
fut. std. 
fut. std. 


fut. std. 
fut. std. 


fut. std. 
fut. std. 
fut. std. 
fut. std. 
fut. std. 
fut. std. 


“fut. std. 


fut. std. 
fut. std. 
fut. std. 
fut. std. 
fut. std. 
fut. std. 


DW 
DW 
DW 
DW 
DW 


DW 


DW 
DW 
DW 
DW 


DW - 


DW 
DW 
DW 
DW 


DW 


DW 
DW 


fut. std. - DW DeleteLine 


UnImpctl 
UnImpCt l 
UniImpctl 
UnImpctl 


UnImpCtl 
ScrollUp 


ScrollDown 


UnImpCt L 
UnImpCt L 
Unimpctl 
UnImpCct lL 
UnImpCtl 
UnImpct l 
UnImpct 
UnImpCt lL 
UnImpctl 
UnImpCt l 
UnImpCtl 


=e =e =a =. =s =e =e me =e =a =e =e =.s =e =a =e 6&8 =. =e =e Ge me =e =e =e =e =e =e =e =e =e =e 


Erase in Field 

Erase in Area 

Delete Character 

Select Editing Extend Mode 
Cursor Position Report 
Scroll Up 

Scroll Down 

Next Page 

Preceding Page 

Cursor Tabulation Control 
Erase Character 

Cursor Vertical Tabulation 
Cursor Backward Tabulation 
fut.. std. 

fut. std. 

fut. std. 

fut. std. 


fut. std. 
10 
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DW -UnImpctlL 
DW  =——: Un mpctl 
DW: UnImpCtl 
DW  —_- UnImpctl 
DW Unimpctl 
DW ~~ Unimpctt 
DW —- Un mpCt 
DW ‘Un mpCtl 
DW  SetMode 
DW ~°UnImpCtl 
DW = - Un mpCtL 
DW Un mpCtlL 
DW = ResetMode 
DW SelGrfRendition 
‘DW UnimpCt t 


Horizontal Position Absolute 
Horizontal Position Relative - 
Repeat 
Device Attributes 

64H Vertical Position Absolute - 

65H Vertical Position Relative 

66H ‘Horizontal and Vertical Position 

67H Tabulation Clear 

68H Set Mode 

69H Media Copy 

6AH fut. std. . 

6BH fut. std. 

6CH Reset Mode 

6DH Select Graphic Rendition 

6EH Device Status Report 


70H Select Active Display 

71H- Select Message Visibility 

72H Select Window Visibility 

73H priv. use 

74H Smooth Scroll Rate 

75H: Character Blink Rate. 

76H Select Cursor Appearance 
; (7H. priv. use 

78H priv. use 

79H ——sowprriv.._ use 

(AH priv. use 

7BH priv. use 

7CH priv. use 

7DH ~sopriv. use 

7EH AMmLFC Load Font: Cell 


DW SelActiveDisp 

DW  SelMessageVis 

DW SelWindowVis 
DW = -UnImpctl 

DW SmoothScr (Rate 

DW CharBLinkRate 

DW SelCursorAppear 

DW =: UnImpCtl 

DW. Unimpctl 

DW UnImpCtl 

DW UnImpcCtt. 

DW UnImpCctl 

DW = Un mpCtl 

DW. UnImpCtl 

DW LoadFontCel l 


; 
: 
; 
i 
7 
r 
; 
: 
DW UnImpCt lt ; 6FH Define Area Qualification 
' 
; 
: 
' 
i 
: 
r 
; 
: 
; 
’ 
; 


PEEEEEE EEE EE EEE EEE E EEE EE EE EEE EE ETAT PTET EET TEEPE ETE TEE T ETE E EET E EEE EEE 


. 


z end of C_Tables 
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ugosiu 7 : GLB SelActiveDisp Select Active Display 
TITLE ™ CALEB 0.00 Control Routines" GLB SelCursorAppear Select Cursor -Appearance 
SEREEEEEER EEF EEERET EEE EEE EEE EEE EEE EEE EE EEE FEE EEE EEE EEE FFE E TEETH TET E ET ETT H tt GLB- SmoothScrlRate Smooth Scroll Rate 
— GLB “SelWindowVis Select Window Visibility 
CALEB 0.00 SelMessageVis Select Message Visibility 


: Copyright 1985 Advanced Micro Devices, Inc. . 
; ; ws | ; in C_Init 
: EraActEnd, EraBgnAct, ChgBlnkSpd, SwpVar, ChgCsrsiz, ChgCsrTyp 
; This file contains all of the control ‘routines supported by ee: Both HidCsr,NewCsr ,PlcCsr,WrAm8052Reg, BLdT rmRcb 
; ANSI ‘standard and AMD a prIvate controls are included. FrcEraRow, EraRow,DelRow_MovDn, InsRow_MovDn,DelRow_MovUp 
InsRow_Movup, Scr lUpNewRow, Scr lUpDsp, Scr lDnDsp, ScrlRtDsp, ScriLtDsp 
NAME "Control Routines™ | DlyTi LEndFrm, HidWnd, Shwknd 
PROG 2 ShwCsr ,SetCelWid,WrFntCel ,SetWndPos 


SEEEEEEETEEELEREEEEE EEE EEE EELEEE EEE EEE PEPE EEE EEE E EEE EEE EEE EEE E TEE FEE t tt ttt ttt PRATER EEE EEE EERE EE EEE EEE EE EEE TEER EEE EEE EEE EEE EEE EE EEE EEE EEE EE EEE EEE EEE 
; ANSI Standard Control Routines a SKIP ee 

INCLUDE C_MemMap 

Backspace : 

Carriage Return SKIP . 


GLB Backspace 

GLB CarriageReturn 
GLB = NewLine 

GLB Reset InitState 
GLB CursorBackward 
GLB _CursorDown 

GLB CursorForward 
GLB CursorPosition 
GLB CursorUp 

GLB DeleteLine 

GLB EraseInDisplay 
GLB EraseInLine 
GLB . InsertLine 

GLB ResetMode 

GLB = ScrollDown 
-GLB Sel GrfRendition 
GLB ScrollLeft 


New L ine ; : 7 FEE EEEEEEFEEE LETHE EEE EEE EEEEE EEE EEE EEEEE EEE EEE EEE EEE ESE EEE EEE EEEE EEE EEE $4444 
Reset to Initial State Backspace: 
Cursor Backward 
Cursor Down Moves the active position left one position on the screen. Backspace does 
Cursor Forward. not support auto wrap therefore the active position can be moved left only 
Cursor Position until it reaches the first memory location of the active row. 
Cursor Up 
Delete Line . inp 
Erase in Display — 7 out 
Erase in Line bad 
Insert Line , 
Reset Mode . 
Scroll Down A,ActCol / Get the current active col 
Select Graphic Rendition . BS1 decrement its value and 
Scroll Left | ActCol test for 0, if 0 do nothing 
- GLB  SetMode Set Mode else decrement ActCol 

GLB ScrollRight Scroll Right PleCsr 

GLB = ScrollUp Scroll Up 


s 
& 
« 
# 
s 
' 
. 
’ 
id 
s 
e 
a 
e 
’ 
. 
f 
s 
a 
s 
f 
. 
g 
e 
’ 
s 
“ ¢f 
« 
a 
s 
f 
e 
a 
_s 
i 
e 
a 


=s 


; AMD Private Control Routines 


GLB = CharBlinkRate Character Blink Rate 
GLB =LoadFontCell ; Load Font Cell 
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ws Se we We Me Se wa 


| CarriageReturn: 


Forces a movement of the active position to the first location on the 


current row. 


Inp ActCol 
Out ActCol loaded to 0 


MOV ActCol, #00H . 
LCALL PlcCsr 
RET 


SEEEELELEEEE TELE EL ESTEE EEE EEE ETE EET ETE EEE TET EEE EEE E EE EPTFE LETT TTT T TEETH ET EE 


NewLine: - 


Moves the active position to move down one row. If the current row is-the 
at the bottom of the screen then a scroll of the screen is done. 


Inp  CurRow 


BtmRow 
Out ActRow incremented to next row page 
BtmRow changed if a scroll has occurred 


A,RO,P2 


. 
g 
ry 
a 
. 
f 
. 
sg 
« 
g 
= 
i 
. 
’ 
. 
gs 
« 
a 


* 


MsgActFlg,NL4 7 : Newline has no action in msg 
ActCol , #0 +: In all cases ActCol goes to 0 
_A,CurRow ; If we are not at the end of the 
A,EndRow, NL1 - - linked list just move to 

next row 
CurRow, ExtRow ~; else make the extra row our 
Scr lUpNewRow _ current row and scroll 


ActRow. : Inc ActRow and test which row 
A, BtmRow,NL2 - ‘next row pointer to use 
- A,RemRow if bottom of screen use RemRow 


NL3" 


_P2,CurRow ‘s else use next row in List 
A, #RCB_RowPag 


ADD A, RcbOf f 


MOV RO,A 


MOVX. A,aRO - > Acc now has next row page ptr 


NL3: 


MOV CurRow,A ‘Update CurRow and cursor pos 
LCALL PlcCsr 


NL4: 


RET o : and leave 


BETHEL EREE ETE EEE ETE EEE EEE ETT EE EE EEE EEE EE TET E EET E EEE EEE E EE EEE E EEE ETE ETE Ett ttt 
ResetInitState: : 


s 
s 


« 
a 
. 
& 
. 
i 
e 
& 
s 
cf 
« 
£ 


Blanks the Am8052.(Mode Register 1--VB=1) without disabling it and waits 
until vertical retrace-time. Then it jumps to the power-up procedure. 
inp none . | 
none 
A,RO,R1,R2,R3, 


DlyTilEndFrm ; Wait until-near end of frame 
R1,#ModReg1Ind In Mode Register.1 | 
R2,#0CCH : _ set normal bits plus VB” 
R3,#001H and leave Am8052 enabled 
WrAm8052Reg ea 
RO, #4 Wait for approximately 

A . ‘ two milliseconds 


RIS1: 


DJNZ ACC,RIS1 
DUNZ RO,RIS1 - 
LUMP Reset . : Go do power-up procedure 


SERRE EL EAE EEE EEE EAE EEEEE EEE EEE EERE EEE EEE EEE EEE EEEEEE EEE EEE EEEEEE EEE EEE EEE 


~ CursorBackward: © 


me Se wa =a 6] -6 moa =e "=e Be 


esseenennmvueeeseseeceeeteecaenseeeunstenaeenneeeeenennenaananen eaeeoauna aeenseas ae 


Moves the active position backward on the screen the indicated number . 
of positions. If no count is suppplied then one position is moved. Also 
if the amount moved is beyond 0 then movement stops at 0. 


Inputs: PrmCnt 

PrmBuf 

ActCol 
Outputs: ActCol altered by the appropriate amount 
bad A 
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Le-a 


ee ee ee a ee ee ee 2 | 


PrmBadF lg, CBW2 


“A, Prmcnt 
JNZ — .CBW_00 


CBW_99: 
MOV A,#1 
-MOV  PrmBuf,A 
SJMP CBW 01 
CBW_00: 
DEC A 
JNZ  CBW2 ~ 


MOV A,PrmBuf 
JZ CBW_99 
CBW.01: 
CLR C 
- XCH A, ActCol 
SUBB A,ActCol 
JNC CBW1 
MOV A,#00H 
CBwW1: 
MOV ActCol,A 
SUMP CBW3 
CBW2: 
MOV A,#00H - 
MOV CtlPtrHi,A 
MOV CtlPtrLo,A 
CBW3: 
*LCALL PleCsr 
RET 


=e =a =e =e =: 


=e =8 wa =e =a 


If a bad parameter buffer is present 
get with an error return 

Test if no parameters 
if none then the default is move 
one_coloumn left 


Then test for only one parameter 
any more parameters is considered 
an error return 


We must subtract the requested 
amount from ActCol and then test 
that we have not moved the 
cursor below 0 

If so make ActCol 0 


Otherwise restore adjusted ActCol 


On an error return remove all traces 
of this control 


* 


Set new cursor position and zone 


EHH HE EEE EEE EEE HEHEHE HEHEHE HEHE thee 


CursorDown: 


Inputs: PrmCnt 
-  PrmBuf 
ActRow 

Outputs: ActRow 


Moves the active position down on the screen the indicated number 
of rows. If no count is suppplied then one row is moved. Also 
if the amount moved is beyond the bottom row then movement ‘stops. 


P altered by the appropriate amount 


A,R2,R3 


‘PrmBadF lg, CD6 


A,Prmcnt 
cD1 


PrmBuf , #1 
CD2 


A 

CD6 - 

A, PrmBuf 
cbo 


WndActFlg,CD3 


‘A, #13 


CD4 


A,#29 . 


C 

A, ActRow 
R2,A . 

A, PrmBuf 
cD5 
R2,PrmBuf 


A, ActRow 
A,R2 
R2,A 
R3,ActCol 
NewCsr 
CD7 


A, #00H 


~CtlPtrHi,A 


CtlPtrLo,A 


If a bad parameter buffer is indicate 
- error return 
Test for zero parameters indicating 
a default value of 1 


If more then 1 parameter this is an 
error return 


If window is active limit of 
movement is 14 


If background is active limit 
of movement is 30 


Set input values for NewCsr 
Setup new cursor variables 
(CurRow, ActRow,ActCol ) 
"and place cursor 


On error remove all traces 
of control 
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Cursor Forsard: SJMP CFW7 and we're done 

: CFW6: 

-Moves the active position forward on the screen the indicated number MOV A,#00H If an error is discovered 

of positions. If no count is suppplied then one position is moved. Also . MOV CtLPtrHi,A remove all traces of this 

if the amount moved is beyond the last column then movement stops. MOV CtlPtrLo,A control 
| | a _| CFW7: | | 

“Inputs: = PrmCnt . , LCALL. PlcCsr Relocate our cursor before we 

) PrmBuf | . 7 | , RET . leave —— * 

ActCol 

Outputs: ActCol altered by the appropriate amount. : ECHL HEHEHE EEE HEHEHE EEE EEE EEE Et 


CursorPosition: 


=. 


Moves the active position to the position on the screen as specified 
--If no valus are suppplied then the active position is moved to the home 
position. Also if either of the parameters are lacking lite the. value 

of 0 is defaulted to. ; 


PrmBadF lg, CFW6 : ‘Indicates a bad parameter buffer 
4 error. return 
A,PrmCnt 
CFW1 
Inputs: PrmCnt 
: PrmBuf 
ActCol 
ActRow 
Outputs: ActCol - altered by the appropriate amount 
ActRow - ws ; 
A,R2,R3,R4 | 


PrmBuf , #1 No parameters indicate a 
CFW2 . movement of 1 


A . If more than 1 parameter 
CFW6 : oo error return 

A, PrmBuf | . 

CFWO 


. 
f 
2 
’ 
. 
f 
s 
’ 
. 
a 
e 
’ 
s 
f 
es 
a 
i? 
’ 
se 
& 
e 
f 
. 
f 
2 
’ 


WndActFlg,CFW3 If window is currently active , -PrmBadF lg, CP9 ; Indicates a bad param buffer | 
A, #39 limit is 40 character pos. ; error return 
CFW4 | | A _ ss Establish default values 
/ | | R2,A 
A,#127 | Else if either Bgd. or Msg . R3,A 
is active limit is 128 A,PrmCnt 
C * cP8 
A,ActCol | | The maximum amount we may move 
R3,A is Limit-ActCol = MAX . A 
A, PrmBuf To determine whether to use Max CP4 
CFWS or requested is Max-Req, if 
Max > Req then move Req /A,Prmcnt 2% Last test for only 2 parameters 
“R3,PrmBuf ; a | A, #02H,CP9 error if jump taken 
| | | : A, PrmBuf+1 > 
A,R3 _ . ~else move Max CP91 
A, ActCol _¢ Add our relative movement to AS 
ActCol,A , our current position 


‘Determine default case 
default if jump taken . 
Set buffer pointer for next prm 
Test if first param is default 
jump if true 


=s ss Fe 3s Me 


=e =6s =n =e ™=s 
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R3,A | 
WndActFlg, €P2 
A, #127 

CP3 


A, #39 


c 
R4,A 
A,R3 
CP4 
A,R4& 
R3,A 


A, PrmBuf 
cP92 
A 


R2,A 
WndActFlg,CP5 
MsgActFlg,CP6 
A, #29 

CP7 


A, #13 


CP7 


A, #0 


Cc 
R4,A 
A,R2 
cP8 

A,R4 
R2,A 


NewCsr 
cP10 


A 
CtlPtrHi,A 


# 


; Limit for window is 40 cols. 
; Limit for bgd and msg is 
128 columns 


* Decide if maximum value or 
requested value is used 
for the new cursor column 


- Calculate new row position 


Limit for Window is 15 rows 
Limit for Message is 1 row 
‘Limit for Background is 30 rows 


Decide -if maximum value or 
requested value is used 
for the new cursor row 


Establish new cursor variables 
and we're finished 


If an error has been detected 
remove all traces of this 


=e =e =e we =e =e =a mae =e 


MOV 
CP10: 
RET 


CtlPtrLo,A 


~ 


control 


SEEEEEEE EERE EELS ETE EEE EEE ETEL ALES EE EE EEE EERE EEE EE EEE EE EE EEE EEE EE EE EEE EEE EET EEE 


Cursorup: 


7 eeuoeeneweeae @esuvpeoeseuvneevenseaeeeevneneeaese es eens vneenewecevesevseseeeneneeanmseveeanvuneacaenunea 


bad 


Inputs: PrmCnt 


PrmBuf 
ActRow 


Outputs: ActRow 


A,R2,R3 


PrmBadF lg, CU4 


A, PrmCnt 
cul 


PrmBuf , #1 
cu2 


A 

CU4 

A, PrmBuf 
cud 


A,ActRow 
C 

A, PrmBuf 
CU3 

. 


R2,A 
R3,ActCol 
NewCsr 
CUS 


Moves the active position up on the screen the indicated number 
of rows. If no count is suppplied then one row is moved. Also 
if the amount moved is beyond the top row then movement stops... 


altered by the appropriate amount 


e 
f 
s 
gs 


Indicates bad param buffer 
error return 


If not zero test if more then 1 param 


e 
fA 
a 
g 


Default (no Parameters) 
Move cursor up 1 row 


If not zero too many parameters error 


Insure that requested -cursor 


movement doesn't move cusor 
below 0 
Absolute minimum cursor vert. 
position 
Set new cursor vert. position 
Maintain current horz. position 
Establish new cursor variables 
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Cu4: 


: If an error occurs remove: 
all traces of this control 


CLR A 
MOV CtLPtrHi,A. : 
MOV CtlPtrLo,A 


CU5: © 


RET 


SEEEEEEEEEEE FEET EEE EEE TEE EEE E EE EEE T EET EE ET ET PTET ETE E TEEPE TET E EEE ETT EE ETE EE 


DeleteLine: 


e 
f 
e 
a 
. 
’ 
e 
f 
° 
a 
e 
f 
° 
’ 
. 
a 
. 
f 
Set 
e 
. 
v 
e 
a 
« 
s 


Deletes the number. of rows specified by the single al lowed parameter. | 
Vertical Editing Mode (VEM) determines whether. blank rows are shifted into 
the bottom or the top of the display. If more rows are specified than can 
be deleted then the maximum amount is deleted. After ensuring parameter 
‘validity this routine waits for vertical smooth scrolling to finish before 
beginning its work. This control is not allowed when the message display 
is active. 


inp none 
out Display dependent variables may change 
A,R2 . 


MsgActFlg,DL9 
_-PrmBadF lg,DL9 
A,PrmCnt 

DL2 


PrmBuf #1. 
DL3 

A a 

DLO - 


A, PrmBuf 
DL1 


vrtScrlFlg,$ 
VEMBit,DL7 
WndActFlg,DL4 
A, #14 - 

DL5 


DL4: 


MOV A, #30 


DL5: 


CLR C 

SUBB A,ActRow 
MOV R2,A 
SUBB A,PrmBuf - 
JC DL6 ~ 

MOV R2,PrmBuf 


DL6: 


LCALL DelRow_MovUp 
DJNZ R2,DL6 
RET 


DL7: 


DL8: 


CLR C | 
MOV A,ActRow 
INC A . 
MOV R2,A 
SUBB- A,PrmBuf 
JC DL8& 

MOV R2,PrmBuf 


LCALL DelRow_Movdn 
DJNZ R2,DL8 
RET 


DLO: 


CLR A 
MOV CtlLPtrHi,A 
MOV CtlPtrLo,A 


RET 


SEEEEEEEEL EEE EEE EE EEE EEE EEE EEE EEE TEE EEE ETT EEE EEE TEETH Tt EPP TTT TTF TTT T TTT Ett 


EraseInmDisplay: 


=e La} =e me me ue =. “me =e =e 


Depending on the parameter sent this control erases from the top of the 
display to the-active postion, the active postion to the bottom of the 
dispplay, or the entire display. ee 


inp = PrmCnt 
PrmBuf 


the count of parameters’ 
buffer containing parameters: 


out none 
bad A,RO,R1,R5,P2 
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JB 


‘JB 


> 


- PrmBadFlg,E1D17 


PrmMaxFlg,EID17 


R1,#PrmBuf 
A,PrmCnt 


 B1DO 


@R1,A 
A 


R2,A 

@R1,#00H ,E1D6 
EraActEnd 

A, CurRow 


A, EndRow, EID3 
EID 16a 


A,BtmRow,EID4 


A,RemRow 
EID5 


P2,A 

A,RcbOff 

A, #RCB_RowPag 
RO,A 

A, aRO 


R5,A - 
FrcEraRow 
A,R5 

EID2 
@R1,#01H,£1D11 


A, BgnRow 


=a =a me me =e “=e 


=s %s %3 Se a 


=e =e ms =e 


Indicates a bad param buffer 
error return 

Indicates too many parameters 
error return. 
parameter buffer 

Prepare for progression thru 


If 0 (default) then erase from 
active pos to last position 
in display 

First erasethe remainder of 
this row and get pointer 


If ptr is last row quit 


If ptr is last row in visible 
dsp start erasing rows below 


Otherwise get next row ptr to 
erase 


Save row pointer 
Erase row 

Restore pointer 
Prepare for next row 


If 1 then erase from beginning 
_ of display. thru active pos 
Start at the beginning of the 


EID7: 
CUNE 


LCALL 
SUMP 
EID8: 
_MOV 
LCALL 
MOV 
CUNE 
MoV 
SUMP 
EID9: 
MOV 
MoV 
ADD 
MOV 
MOVX 
SUMP 
EID11: 
CUNE 


MOV 
EID12: 
MOV 
LCALL 
MOV 
CJUNE 
SUMP 
EID13: 
CJUNE 


MOV 
SUMP 
EID14: 
MOV 
MOV 
ADD 
MOV 
MOVX 
SJMP 


A,CurRow,EID8& 


EraBgnAct 
EID16a 


R5,A 
FrcEraRow 
A,R5 
A,BtmRow, EID9 
A,RemRow 
EID7 - 


P2,A 
A,Rcboff ° 
A,#RCB_RowPag 
RO,A ) 

A, aRO 

EID7 


@R1,#02H,E1D16 
A, BgnRow 

R5,A 

FrcEraRow 

A,R5 
A,EndRow,E1D13 
EID16a 


A,BtmRow,E1D14 


A,RemRow 
EID12 


‘P2,A 


A, Rcboff 
A,#RCB_RowPag 
RO,A 

A, ARO 

EID12 


=e =e =e me 


Linked list 
If not at top get erase first 
first row vs 
Finally erase current row to 
active pos. and get next pim 


Preserve erased page ptr 
erase this row 


Test for bottom of display 


if true, next row is RemRow 


Otherwise get next row in list 


Proceed to erase it 


If 2 then erase from top to 


bot tom 
Start at the beginning 


Erase this row then proceed 
to the next appropriate 
Continue til last row is done 
then procedd with next param 


When we reach the bottom of the 
dsp start with RemRow and 
continue 


Otherwise just continue with 
the next row 
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. 
s 
. 
s 

. 
a 
. 
a 
. 
f 
. 
f 
° 
f 
. 
ad 
. 


EID16a: 


MOV 


_A,ExtRow 


LCALL FrcEraRow 


EID16: 
INC 


R1 


DJNZ. R2,EID1 
LCALL PlcCsr 


RET 


EID17: 


CLR 
MOV 

~ MOV 
EID18: 
RET 


A 


‘CtlPtrHi,A 


CtlPtrLo,A 


: done with this parameter 
; Point to next parameter 

; If more parameters proceed 
3; , else return 


SEEEEEEEEL EEE EE EEFEL ESET EE PEATE TEE TEE EEE TEEPE EEE ETE EEE E PTET TT TT ETE Ett ttt ttt ttt 


EraseInLine: © 


=a’ 
a 


inp 


out 


Prmcnt 
Prmbuf 
none 
A,R1,R2 


‘Denpending on the parameter sent this control erases from the beginning 
of the row to the active position, the active post tion to the end of 
‘the row, or the entire row. 


the count of parameters 
buffer containing control params 


. 
s 
) 
a 
e 
a 
s 
s 
8 
a 
s 
s 
® 
s 
t) 
6 
e 
® 
i] 
e 
e 
s 
8 
e 
s 
a 
s 
e 
e 
a 
s 
s 
e 
2 
8 
a 
® 
8 
s 
s 
t) 
. 
s 
s 
s 
8 
® 
8 
t 
a 
a 
s 
e 
s 
s 
e 
8 
a 
s 
a 
i 
s 
® 
s 
s 
s 
e 
L) 
e 
s 
e 
8 
s 
6 
a 
e 
a 
e 
6 


Cc. 
Lo.) 


PrmBadFlg,EIL5 
PrmMaxFlg,EIL5 
R1,#PrmBuf 


A,PrmCnt 
EILO 


- @R1,A 


A 
R2,A 


@R1,#00H,EIL2— 


; Indicates a bad param buffer 

: error return : 
; Indicates too many parameters 
: error return 

; Point to first parameter value 


: and function to 0- 
; If default, set count to 1 


; Test for each of the allowed aaa 
; Each in turn 


LCALL 
SJMP . 


EIL2: 
UNE 
LCALL 
— SJMP 
EIL3: 
CJNE 
MOV 
LCALL 
EIL4: 
INC 
DUNZ 
SJMP 
EIL5: 
CLR 
MOV 
MOV 
EIL6: 
RET 


EraActEnd 
EIL4 


aR1,#01H, EIL3 


EraBgnaAct 
EIL4 


OR1, #02H, EIL4 
A,CurRow 
FrcEraRow 


RD 
R2,EIL1 
EIL6 


A 
CtlPtrHi,A 
CtlPtrlo,A 


If 0 (default) then erase from 1 
active pos to end of row 


If 1 then erase from beginning 
of row until the active pos. 


» 


; If 2 then erase the whole Line 


_Update our pointer into PrmBuf 
and get all the parameters 


If an error was detected. remove 
all traces of this control 


-_ 


yet 


HEE 


InsertLine: 


ma 


inp 


, out 


=e Ss Se BB Se Be Be ME Bs Be We We Ws 


beginning its work. 
is active. 


Prmtnt 
PrmBuf 
none 


Inserts the number of rows specified by the single allowed parameter. The 
Vertical Editing Mode (VEM) determines whether blank rows are shifted into 
the bottom or the top of the display. 
be inserted then the maximum amount is inserted. After ensuring parameter 
validity this routine waits for vertical smooth scrolling to finish before 
This control is not allowed when the message display 


If more rows are specified than can 


parameter count 
buffer containing parameter(s) 
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‘MsgActFlg,IL9 


PrmBadF lg, IL9 
A,PrmCnt 
IL2 


PrmBuf , #1° 
IL3 


A 
IL9 
A, PrmBut 
IL1 


VrtScrlFlg,$ 


VEMBit, IL7 
WndActFlg, IL4 
A,#14 

IL5 


A, #30 


C 

A, ActRow 
R2,A 

A, PrmBuf 
IL6 


“R2,PrmBuf - 


InsRow_MovDn 
R2,1L6 


c 


-A, ActRow 


A 


- R2,A 


A,, PrmBuf 
IL8 


R2, PrmBuf 


« 
=e “=e =s8 =e =e 


x 
=e =e =e me =. =e 


‘Insert line is not functional 


in message window 

Bad parameter buf fer 

Test for default parameter 
jump if not default 


Else setup variables for 
default 


Test for only one parameter 
if not zero too many prms 
0 is handled as: a prm of 1 


If a scroll is in progress 
wait til finished to cont. 
Decide which way to move rows 
Bgd is active if -taken 
Limit of insert in window 
is fourteen 


Limit for background is thirty 


.Maximum amount able to move 


Max=Limit-Current 
Preserve maximum 


If taken move maximum 
else move requested 


Insert rows 
Count times 


With VEM bit set we just check 
how far it is to the top 


-and use the smaller value 


=e Sse Se Be Be M0 Me Be Be Be Ws 


IL8: 
LCALL InsRow_MovUp 
DJNZ R2,IL8 
RET 

IL9: 
-CLR A 
MOV CtlPtrHi,A 
MOV CtlPtrLo,A 
RET 


a 
& 
. 
’ 
. 
e 


Insert count rows 


If an error was indicated 
remove all traces of this 
controll 


SEEEEEEEELEEEEEEEEEE EET EE EEE EEE EEEE EE ESTEE EEE EEE EEE EEE E EET E EEE EEE E EEE EET 


 ResetMode: 


states. 


=e we =e =e 


Parameters 


Prment 

PrmBuf 

none 
A,RO,R1,R2,R3,R6,DPTR 


JB PrmBadFlg,RSTMD7 
JB PrmMaxFlg,RSTMD7 


MOV A,PrmCnt 

JZ -RSTMD8 

MOV R6,A 

MOV. RO, #PrmBuf 
RSTMD1: 

MOV A,PrmPvt 

JZ RSTMD5 


Meaning 


Reset the modes indicated by the selective parameters to their initial 


VEM (insert/delete above active row) . 
AMDDWM (compressed) 

AMDSCM (smooth scrolling) 

AMDSPM (reversed screen) 


‘count of parameters sent 


buffer containing parameters 


Indicates a bad param buffer 

, error return 

Indicates too many parameters 
error return 
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RSTMD2: 
‘CJUNE 
-JNB 
@ 


@RO, #03H, RSTMD3 
AMDDWMBit, RSTMD6 


LCALL RMdSup 
RSTMD6° 


_ SUMP 
RSTMD3: 
CJUNE 
“CLR 
. SUMP 
RSTMD4: 
CJUNE 
CLR 
SJMP 


RSTMD5 =" 


CJNE 


CLR 
RSTMD6: 
INC 
DJNZ 
SJMP 


RSTMD7: 


CLR 
MOV 

~ MOV 
RSTMD8: 


RMdSup: 


JB 
- JB 


MOV - 


~ MOV 


ARO, #04, RSTMD4 
AMDSCMBit 
RSTMD6 


@RO, #05H, RSTMD6 
AMDSPMBit 
RSTMD6 


_ RO, #07H, RSTMDS 


VEMBit 


RO 


6, RSTMD1 


RSTMD8 


A 
CtlPtrHi,A 
CtlPtrLo,A 


VrtScrlFlg,$ 
HrzScrlFtg,$ 
HrzFrmSet,RO 
HrzPxLShf,R6 


LCALL DlyTilEndFrm 


MOV 
MOV 
MOV 


R1,#ModReg1 Ind 
R2, #0CCH 
R3, #001H 


. LCALL WrAm8052Reg 


CLR 


MOV . 


AMDDWMB it 
A, #007H 


AMDDWM (normal mode) 


- AMDSCM. (jump scrolling) 


AMDSPM (normal screen) 


VEM Cinsert/delete below active 


row) 


If an error is indicated 
remove all traces of 
this control 


~ LCALL 


MOV 
LCALL 
JB 

JB 


SetCelWid 
VisCol , #0 
SetWndPos 
MsgActFlg,RMd0 
WndActFlg,RMd0 
A, BgnRow 

RMd1 


DPTR, #8gdVarBuf+(BgnRow-CurAtr) 
A,@DPTR © 


DPH,A 
DPL,#BgdRCBO.AN.OFST+RCB_RowPag 
R1,#6 


A, @DPTR 

DPH,A 

R1,RMd2 | 
DPTR, #8gdVarBuf+(TopRow-CurAtr) 
EXO 

QDPTR,A & 
DPTR,#BgdMDBO+MDB_RowPag * 
QDPTR,A ; 
DPTR,#BgdMDB1+MDB_RowPag 
@DPTR,A 

MsgActFlg,RMd3 

WndActFlg,RMd4 

TopRow,A 

VisRow, #6 . 

DspHgt , #24 


DspWid, #80 


DPTR, #BgdVarBuf+(VisCol -CurAtr) 
A 


_@DPTR,A 


DPL 
A, #6 
QDPTR,A 


~ DPTR, #MsgVarBuf+(VisCol -CurAtr) 


A : 
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@OPTR,A 
A, #034H_. 
DPTR,#BgdMDBO+MDB_Tslc 
@DPTR,A. : 
DPTR,#BgdMDB1+MDB_Tslc 
@DPTR,A 

DPTR, #NrmRRB+RRB_Tslc_NcsHi 
@DPTR,A 

DPL 

A, #04DH 

@DPTR,A 

DPL 


A 


@DPTR,A 
DPL 

A, #00DH 
@DPTR,A 
DPL 
A 
@DPTR,A 
DPL - 
A, #08DH 
@DPTR,A 
DPL 

DPL 

DPL 


_ A, #001H 


@DPTR,A 
DPL 
A, #086H 


@DPTR,A 
“MsgVisFlg,RMd9 
“A, #26 


RMd10 


A, #24 


DPTR, #TrmWDB+WDB_BgnRow 
@DPTR,A 

DPL 

@DPTR,A 

A, #26 


MOV 
MOVX 
INC 
‘MOVX 
— SETB 
JNB 
MOV 
RMd11: 
MOV 
CJNE 
MOV 
SJMP 
RMd5 : 
CJNE 
-MOV 
SJMP 
RMd6: 
CJUNE 
MOV 
SJMP 
RMd?: 
MOV 
RMd8 : 
LCALL 
MOV 
MOV 
MOV 
_ LCALL 
LCALL 
MOV 
" MOV 
RET 


DPTR, #MSGWDB+WDB_BgnRow 
@DPTR,A 

DPL 

@OPTR,A 

EXO 

MsgActFlg,RMd11 

RowAdd, #24 


A,CsrSiz 

A, #09AH, RMdS 
CsrSiz,#0BCH 
RMd8& 


A, #OAAH,RMG6 
CsrSiz,#0CCH 
RMd8& 


“A, #058H , RMd7 


CsrSiz,#06AH 
RMd8 


CsrSiz,#00DH 


ChgCsrSiz 
R1,#ModReg1 Ind 
R2,#0C8H 
R3,#001H 
WrAm8052Reg 
PlcCsr 
RO,HrzFrmSet 
R6, HrzPxlShf 


SEEEEELELELE EEL ESTEE EEE EEE EEE E EEE EET E TEE EEE TEETH TTF FETE TEETH ttt ttt ttt tte 


ScrollDown: 


inp - 


=e Ss Be Se Be we 


PrmCnt 
PrmBuf 


Scrolis number of rows specified by the single allowed parameter. 
If more rows are specified than can be scrolled then the maximum amount is 
scrolled. : 


parameter’ count — 
buffer. containing parameter(s) 
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SD4: 


_ PrmBadFlg,SD5 


Cc 
JB MsgActFlg, SD6 


MOV A,PrmCnt . 
JNZ SD1 
MOV’ PrmBuf, #1 
SJMP SD2 ~ 
SD1: 
DEC A 
JNZ  SD5 
SD2: 

“MOV A,PrmBuf 
SUBB A,VisRow 
JC —- SD3 
MOV A,VisRow 
JZ -SD6 
“SJMP = SD4 


’ §D3: 


MOV A,PrmBuf 


LCALL SerlDnDsp 
SJMP SD6 
SD5: 
CLR A 
MOV CtlPtrHi,A 
MOV CtlPtrlo,A 
SD6: _ 
~ RET 


Indicates a bad param buffer. 
error return 


Message window cannot scroll 
vertically 

If count = 0 default to 1 row 

If more then one parameter 
error return 


Amount to scroll is the smaller jof 
requested rows Vs. VisRow — 


Scroll in progress 
and we're finished 


Onan error remove all traces 
of this control 
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SelGrfRendition: 


=e Se Me Me 


Parameters 


2791 

292 | 

293 

any other parameter is ignored 


PrmCnt 
PrmBuf 
none 
A,R1,R3 


a) 
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s 
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e 
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PrmBadF lg, SGRO1 
SORI6 

PriMaxF Lg, SGRO2 
SGR16 
A,Prmcnt 


SGRXX 
SGR16 


After checking parameter validity tests this control changes the following 
character attributes depending on the selective parameter(s) sent. 


meaning 


‘Steady, initial attributes 


Bold, hi intensity 
Under l ined 
Blinking 

Negative image 
Crossed out 
Primary Font 
Secondary Font 
Normal intensity 
Not underlined 


- Steady (not blinking) 


Positive image 

Not crossed out 
Superscript alignment 
Subscript alignment 
Normal alignment 


_number of parameters to work on 


buffer containing the parameter(s) 


a 
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: Indicates a bad param buffer 
‘ error return 


Indicates too many parameters 
error return 
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R3,A 
R1,#PrmBuf 


A,PrmPvt 
SGR4 

OR1, #91, SGR2 
SpsBit 
SbsBit 

SGR15 


OR1,#92,SGR3 
SbsBit 
SpsBit 

SGR15 


aR 1, #93 , SGR4 
SpsBit 
SbsBit 
SGR15 


aR1,#00,SGR5 
CurAtr, #00 
SGR15 


€R1, #01, SGR6 


LitBit 
SGR15 
AR1, #04, SGR7 
UndBit 
SGR15 


AR1, #05, SGR8 
BLnkBit 
SGR15 


aR1,#07,SGR9 
RevBit © 


- SGR15, © 


; Test if AMD private control 


; Superscript alignment 


; Subscript alignment 


; Normal alignment 


~ 


; Steady initial attribute 


; Underlined 
; Blinking 


; Negative image 


aR1,#09,SGR_09 
SundBit 
SGR15 


@R1,#10,SGR_010 
FntMapFlg 
SGR15 


aR1,#11,SGR10 
FntMapF lg 
SGR15 


aR1,#22,SGR11 
LitBit 
SGR15 


aR1, #24, SGR12 
UndBit 
SGR15 


aR1, #25, SGR13 
BlnkBit , 
SGR15 ~ 


aR1,#27,SGR14 
RevBit 
SGR15 


aR 1, #29, SGR15 
SundBit 


R1 
R3,SGR1 


A 
CtlPtrHi,A 
CtlPtrLo,A 


Crossed out 


Primary font 


Secondary font 


Horaet intensity , 

Not eens 

Steady (not bl inking) 
sdeicive-imeds 

Not crossed out 

If an error was indicated 


remove all traces of 
this routine 
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ScrollLeft: 


Scrolls. the display leftward the number of columns specified by the single 
numeric parameter. An attempt to scroll the rightmost column of the display 
leftward beyond the rightmost column on the monitor leaves it at the right 


most column. 


inp = Prment 
PrmBuf 
out ene ~ 


y bad | A,R1,R2 


JB -PrmBadFlg,SL7 
JB wndActFlg,SL8 


A, PrmCnt 
SLI 
PrmBuf , #1 
SL2 | 


A 
SL7 


AMDDWMBit, SL3 


R2,#8 
SL4 


R2, #48 


C 
A,VisCol 
A,R2 
A,R2- 
SL8 - 
R7,A 
A,PrmBuf 
C 
A,R7 
SL5- 

R7, PrmBuf 


count of parameters 
buffer containing the parameters 


; Indicates .a bad param buffer 
: error return 

If Window Horz. scrolling is not 
allowed 


If no parameters default to 1 column 
If more then one parameter error rtn 


If compressed mode maximum number 
of colums to be scrolled is 48 


‘Else colums = 8 


Number of columns available for 
_ scrolling = Maximum - VisCol 


smaller of Available Vs. requested 


SL5: 
MOV 


A,R7 


LCALL ScrlLtDsp 


RET 
SL7: 

CLR 

MOV 

* Mov 
SL8: 

RET 


A 
CtlPtrHi,A 
CtlPtrLo,A 


> If error remove all traces of 
: control routine 


: FEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE EEE EE EE EEE EEE EERE EEE EEE EEE EEE EERE EEE EEE EEE 


_ SetMode: 


=e =e =e =e 


oe 
e 
. 
a 
J 
e 
° 
a 
e 
a 
s 
a 
e 
f 
e 
a 
e 
a 
es 
g 
. 
a 
s 
g 
s 
i 


states. 


Parameters 


Prmtnt 
PrmBuf 


none 


A,RO,R1,R2,R3,R6,DPTR 


PrmBadF lg, STMD7 
PrmMaxFlg,STMD7 


A,PrmCnt 
STMD8 


‘R6,A 


RO, #PrmBuf _ 


A,PrmPvt 
STMDS 


Meaning 


Set the modes indicated by the selective parameters to their alternate 


VEM Cinsert/delete above active row) | 
AMDDWM (compressed) 

AMDSCM (smooth scrolling) 

AMDSPM (reversed screen) 


count of parameters sent 
buffer containing parameters 


=e Se Se Bs Be 


Indicates a bad param buffer 
error return 

Indicates too many parameters 
- error -return 

If zero no action just return | 


Establish loop count from PrmCnt 

Establish pointer for param 
compar isons 

Test if private selective 
parameter 
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ARO, #03H, STMD3 
AMDDWMBit, STMD6 
smMdSup, 

STMD6 


“ORO, #04H, STMD4 


AMDSCMBit 


-STMD6 : Ane 


ARO, #05H, STMD6 
AMDSPMBit 
STMD6 ~ 


@RO, #07H, STMD6 
 VEMBit 


RO 
R6,STMD1 
STMD8 


A 
CtlPtrHi,A 
CtlPtrLo,A 


VrtScrlFlg,$ 
HrzScrlFlg,$ 


“HezFrmSet,RO 


HirzPxLShf,R6 
DlyTilEndFrm 
R1,#ModReg1Ind 
R2,#0CCH: 


-R3,#001H 


WrAm8052Reg 
AMDDWMBit © 


~ A, #004H 


_ AMDDWM Compressed mode 


; AMDSCM Smooth scrolling 


; AMDSPM reversed screen 


If an error is indicated 
remove all traces of 
this control — 


LCALL 
MOV 
LCALL 
ia” 
JB 


SetCelWid 
VisCol , #0 
SetWndPos 


. MsgActFlg, SMd1 


WndActF lg, SMd1 


 R4,BgnRow 


R1,B8tmRow 
R2,RemRow 
R3, EndRow 
SMd2 


DPTR ,#B8gdVarBuf+(BgnRow-CurAtr) 
EXO 
A,@DPTR 
R4,A 
DPL 

DPL 
A, Q0PTR. 
DPL 
R1,A 

A, Q0PTR 
DPL 
R2,A 

A, @DPTR 
R3,A 


DPH,R1 a 
DPL , #BgdRCBO.AN.OFST+RCB_RowPag 
A,R2 

@DPTR,A 

DPL 

A, #8gdRCBO.AN.OFST 


 @DPTR,A 


DPH,R3, 

A, TrmOff 

@DPTR,A 

DPL . 

A, TrmRow 

@DPTR,A 

DPTR, #BgdVarBuf+( TopRow-CurAtr) 
A,R4. 

aDPTR, A 





DPTR,#BgdMDBO+MDB_RowPag 
@DPTR,A 
DPTR,#BgdMDB1+MDB RowPag 
QDPTR,A . 


’ MsgActFlg, SMd3 


WndActFlg, SMd4 


- TopRow,A 


VisRow, #0 
BtmRow, R3 
RemRow, R3 
DspHgt , #30 


DspWid, #120 


DPTR, #BgdVarBuf+(VisCol -CurAtr) 


A 


@DPTR,A 
DPL 

aDPTR,A 

DPL 

DPL 

A,R4 

@DPTR,A 

DPL 

A,R3 

aDPTR,A 

DPL 

QDPTR,A 

DPTR, #MsgVarBuf+(VisCol -CurAtr) 
A 

QDPTR,A 


_ A, #028H 


DPTR, #BgdMDBO+MDB _Tslc 
@DPTR,A - 
DPTR, #8gdMDB1+MDB Tslc 
@DPTR,A 


_ DPTR, #NrmRRB+RRB_ Tslc_NcsHi 


@DPTR,A . 
DPL 

A, #04AH 

@DPTR;A 

DPL 


A, #001H 
QDPTR,A 

DPL 

A, #045H 
@DPTR,A 
MsgVisFlg, SMd9 
A, #32 

SMd10 


A, #30 


DPTR,#TrmWDB+WDB_BgnRow 
QDPTR,A 

DPL 

QDPTR,A 

A, #30 

‘PTR, #MSQWDB+WDB_BgnRow 
@DPTR,A 

DPL 

@DPTR,A 

EXO 

MsgActFlg,SMd11 

RowAdd, #30 


A,CsrSiz 

A, #0BCH, SMd5_ 
CsrSiz,#09AH 
SMd8 . 
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_SMd5: > 


CUNE 
-MOV 
SJMP 
SMd6: 
CUNE 
MOV 
SJMP 
SMd7: 
- MOV 
SMdB8 : 
LCALL 
MOV 
MOV 
MOV 
LCALL 
LCALL 
MOV 
~ MOV 
RET 


A, #OCCH ,SMd6 
CsrSiz,#0AAH 
SMd8& 


A, #06AH, SMd7 
CsrSiz,#058H 
SMd8 


CsrSiz,#00AH 


ChgCsrSiz 


_R1,#ModReg1 Ind 
-R2, #0C8H 


R3,#001H 
WrAm8052Reg 
lcCsr =, 
RO, HrzFrmSet 
R6,HrzPxlShf 


SEEFEEEEEEEEE FETE EEEEEEE FEL ELE EEE EF EL EEF EEE EEE EEEEEEEEEEEEEF EEE EE EE EEE Ett tt 
ScrollRight: 


. 
ti 


‘Scrol 


ls the display rightward the number of columns specified by the single 


numeric parameter. An attempt to scroll the leftmost column of the display 


rightward beyond the leftmost column on the monitor leaves it at the left- 


most column. 


: 
: 
: 
: 
; 
; inp 
: 
; 
: 
; 


Prmcnt count of parameters 

PrmBuf - , buffer containing the parameters 
none 

A 


eeeneeeeeesnevnanseesenssaetesuenneveeeeeeceosneesesseseneweeeneeveoeveeaeneannenenenen 


= 


PrmBadFlg,SR5 : Indicates a bad param buffer 
. : error return 

C 

WndActFlg,SR6 ;Window cannot scroll horz. 


' A,PrmCnt . ;Zero Parameters default to 


SR1 


MOV PrmBuf ,#1 
SJMP  SR2 

SR1: 
DEC A 
JNZ = SRS 

SR2: 
MOV A, PrmBuf 
SUBB A,VisCol 
JC = SR3 
MOV A,VisCol 
JZ SRO 
-MOVR7,A 
SUMP SR4 


. SR3: 


- MOV. ~~ R7/, PrmBuf 


SR4: 


MOV A,R7 
LCALL ScrlRtDsp 
“RET 


. SR5: 


CLR A 

MOV CtlPtrHi,A 

MOV CtlPtrLo,A 
SR6: 

RET 


sone row 


;If more then one parameter this 
« 4 
: is an error return 


;Amount scrolled is equal to the -|- 


: ‘small of requested columns 
: Vs.Vis.Col 


7Scroll ‘in Progress 


zl f- error remove all traces of 
: of control 
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Scrol lUp: 


display. 


inp = Prment 
PrmBuf 

out none 
A,R1,R2 


=e “=e Fe Bs Be Bs We We WH Ws 


PrmBadF lg, SU6 


Scrolls the display upward the number of columns specified by the single 
numeric parameter. An attempt to scroll the bottom row of the display 
upward beyond the. bottom row-on the monitor leaves it at.the bottom of the 


count of parameters 
buffer containing the parameters 


; Indicates a bad param buffer 
: error return 





cS-C 


JB 
MOV 
JNZ- 
MOV 
SJMP 


SUI: 


’ DEC 

JNZ 
SU01: 
JB 


MOV 
JB 
SJMP 

su2: 

MOV 


“‘SU3: 


CLR 
“MOV 
XCH 


' —SUBB™ 


iz 
MOV 
MOV 
CLR 

- SUBB~ 
JC 
MOV 
SJMP 

SU4: 

MOV 


$u5: 
LCALL 
SJMP 
SU6: 
CLR 
MOV 
MOV 
SU7: 
RET 


MsgActFlg,SU7 


A,PrmCnt 
“sui 


PrmBuf , #1 
Su01 


A 


“ $U6 
‘WndActFlg, SU2 


R2,#6 


AMDDWMBit , SU7 
su3 


R2,#7 


C 

A, VisRow 
A,R2 
A,R2 

SU7 
R1,A 
A,PrmBuf 
CL 
A,R1 
SU4 
A,R1 
SU5 


A, PrmBuf . 


ScrlUpDsp | 


SU7 


A 
CtlPtrHi,A 


CtlPtrlo,A 
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+If message active vert scroll 


; not allowed 
:1f no parameter, default the 
> one row 


:If more than one parameter this 
: is an error return 


_tIf window is active maximum 


: scroll value is 7 

: or background max is 6 

:I1f im compressed mode scroll is 
: not allowed 


3;The current allowed is maximum 


3: _MisCut 


; save max to move for later 


;Request amount to scroll - 
;Move either requested amount or 


a maximum allowed 


z;I1f requested is less then 
3 - allowed do that many 


3; Scroll in progress 
: we're done 


If an error clear history ptr 


_7Done 


=e me ee =e =e =e =e me ee me =e ue me —s 


CharBlinkRate: 


=e =e me =e 


out 
bad 


Parameters 


“Selects the. rate and duty cycle for characters dispalyed with the blink 
attribute 


Meaning | 


Initial blink, fastest, 25/75 cycle 
Blink 50/50 cycle 

Blink 25/75 cycle 
_ Fastest. blink rate — 

Fast blink rate 

Slow blink rate 

Slowest blink rate 


~ Prmcnt 


PrmBuf 
none 
A,R1,R2 


count of parameters 


buffer containing the parameters :|” 


eeaense wees eneeeeseeeesseenenen een eesneesenee2e Seeaennevenwnvneneveenneeneaon eepeeeeeneeenupanan a a 


JB 
JB 


MOV 
MOV 
JNZ 
MOV 
INC 
CBRO:. 
MOV 
CBR1: 
CJNE 


_ SETB. 


CLR 
CLR 


SUMP 
CBR2: 
. CJUNE 


SETB 
-SJMP 


PrmBadF lg, CBR9 
PrmMaxF lg, CBR9 
R1,#PrmBuf 

A, PrmCnt 

CBRO 

aR1,A 

A 

R2,A 


aR1,#00, CBR2 


ChdBit 


ChbBit1 
ChbBit0 
CBR8 


-@R1,#11, CBR3 


ChdBit 


-CBR8 


3.6 


a Indicates a bad param buffer 
; error return 
; Indicates too many parameters 
: error return 


; initial type 


7 Blink 50/50 


a 


€¢-d 


CBR3: 
CJNE 
CLR. 
SJMP 

CBR4: 
CJUNE 
CLR- 
CLR 
SJMP 

CBR5: 

.CJNE 
CLR 
SETB 

’ SJMP 

CBR6: ~ 
CJNE 
SETB 

“CLR 
SJMP 

CBR7: 
CJNE 
SETB 
SETB 

CBR8: 
INC 
DJNZ 
LCALL 
SJMP 

CBR9: 
CLR 

MOV 
MOV 
CBR10: 


@R1,#12,CBR4 


ChaBit 
CBR8& 


@R1,#20, CBR5 


ChbBit1 
ChbBi tO 
CBR8 - 


@R1,#21,CBR6 


ChbBit1 
ChbBitO 
CBR8 


@R1,#22,CBR7 


ChbBit1 
ChbBi to 
CBR8& 


AR 1, #23, CBRE 


ChbBit1 
ChbBi tO 


“RI 


R2,CBR1 


ChgBlnkSpd . 


CBR10 


A. 


CtlPtrhi,A 
-CtlPtrLlo,A 


RET. *- - = 


; Blink 25/75. 


Fastest rate 


Fast rate 


Slow rate - 


Slowest rate 


If an error is detected remove 
all traces of this control 
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LoadFontCel lL: 


Loads a cell of the character generator RAM at the location, and with the 


address (0-255), the second is the starting slice (counting downward from 


: 
; pattern, specified in the parameters. The first parameter is the cell 
: 
: 


zero) and the remaining parameters are the patterns for each slice working 


downward. 


PrmBadF lg, LFC5 


A,PrmCnt 
LFC1 
PrmBuf , #0 
LFC2 


A 
LFC3 


PrmBuf+1 , #0 
PrmCnt , #2 
LFC4 


Cc 
A,#17 
LFC5 


A,#" * LFC6 


A 
CtlPtrHi,A 
CtlPtrLo,A 


A, PrmBuf+1 
A,Prmctnt 
C- 

A, #18 
LFC5 
HidCsr 


_VrtScrlFlg,$ 


HrzScrlFlg,$ 
A 


AMDDWMBit, LFC7 


A’ 


Unspecified slices are loaded with zeroes. After checking fo 
parameter validity this routine waits until all smooth scrolling is finished 
before beginning its work. 


The Display Width Mode (AMDDWM) determines which 


Indicates a bad param buffer 
error return 





 ¥G- 


- LFC7: 


LCALL WrFntCel 
LCALL ShwCsr 
~ RET , 
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‘SelActiveDisp: - 


Selects the currently active display, background, window, or message. 
attribute 


e 
f 


ae =e =e =e 


Parameters _ Meaning 

‘makes the background display active 
makes. the message display active- 
makes the window display active 


Prmcnt ' count of parameters 

- PrmBuf buffer containing the parameters. 
none | . 
A,R1,R2,R4,R5 


@aeeesovonvpnvnveveenvneecenneeveeseveeecvnecanrnaouaeve 


. 
a 
e 
ri 
e 
- 
s 
e 
e 
a 
° 
e 
« 
’ 
° 
# 
s 
g 
° 
# 


PrmBadFlg,SAD1 ; Indicates a bad param buffer 
SAD19 error return 


PraMaxFlg,SAD2 — ; Indicates too many parameters 
SAD19. : error return 


VrtScrlFlg,$ 
HrzScrlFlg,$ 
R1,#PrmBuf - 
A,PrmCnt 
SAD2a 

@R1,A 

A 


- R2,A 


@R1,#00H , SAD3a 
SAD3b 


SAD9 


SAD3b: 

MOV _R5,#B8gdVarBuf .SR-PAGE 
MOV _R6, #BgdVarBuf.AN.OFST 
JB _MsgActFlg, SAD5 

JB WndActFlg,SAD4 


LJMP SAD18 
SAD4: 
MOV R3,#WndVarBuf .SR.PAGE 
MOV. R4,#WndVarBuf.AN.OFST 
LCALL BldTrmRcb 
SJMP SAD6 
SAD5: 
MOV R3,#MsgVarBuf.SR.PAGE 
MOV R4,#MsgVarBuf .AN.OFST 
SAD6: : 
LCALL SwpVar 
CLR WndActFlg 
CLR MsgActFlg. 
JB. AMDDWMBit,SAD7 — 
MOV DspWid,#80 
MOV DspHgt,#24 
SJMP SAD8& 
SAD7: 
MOV DspWid,#120 
MOV DspHgt, #30 
SAD8: | 
MOV ColAdd, #01 
MOV RowAdd, #00 
MOV RcbOff,#BgdRCBO.AN.OFST. 
MOV ChrOff ,#BgdChrBuf0.AN.OFST 
MOV §AtrOff,#BgdAtrBuf0.AN.OFST 
MOV P2, ExtRow: . 
MOV A,RcbOff 
ADD A,#RCB_RowPag 
MOV RO,A 
MOV A,ExtRow 
MOVX. @RO,A 
INC RO 
MOV A,RcbOff 
MOVX aRO,A 


| me me Ge =e Me 


Make the background display 


active 
4 


If Background is already active 
do nothing further 


If the wnd window was active 
move its dsp. vars. out 


If the msg window was active 
move its-dsp. vars. out 


Indicate current active state 
With internal. flags 


Update non-moving display vars. |. 


Set page address to extra row. 
Build offset into RCB at. 
next row ‘pointer 
Use RO as index pointer 
Next row pointer = ExtRow 
Store it in RCB 
Get index to offset 
Move current rcb offset 
Store it 





¢S-a 


RO 
A 
@RO,A 
RO 

A 
@RO,A 
RO 

A, #080H 
aRO,A 
RO 

A 
RO,A 


RO 


A, #BgdFncChr0.SR.PAGE 
aRO,A 

RO. 
A,#BgdFncChr0.AN.OFST 
@RO,A 

RO 

A 

aRO,A 

RO 

@RO,A - 

RO 

A, #BgdFncAtr0.SR .PAGE 
@RO,A . . 
RO 

A, #BgdFncAtrO.AN.OFST 


“@RO,A 


RO 
A,VisCol 
aR0,A 
RO 


- ©. 


A,WndCol 


JA 


ARO, A 
RO 

A, #80H 
@RO,A 
RO 


=e =e =e =e =e. me =e ma ~s La] ma =e 


La) =—s =e me =n =e =e =e =a 


wa =e ™e =e =e we 


ue 


Set hidden count 


Store hidden count 
Index to visible count. 
Set visible count to 1 
Store it 


Continue bit set 


. Store always zero byte 


Index to chr ptr page 

Set to current function char 
Store it in RCB 

Index to chr ptr offset 
Offset of function character 
Stored 


Store empty word in RCB 


Index to atr page 
Build Attribute page 
Store page to atr 
Index to atr offset 


Store it 


Length of hidden 2nd seg=VisCol | 
Store it » 
Index to visible 2nd segment 


Visible count = WndCol-VisCol 
We get negative so complement 
Store it. 

Index to continue bit 

Set continue bit 0 rest of byte 
Store it 

and 1 empty byte 


@R1,#02,SAD13. 

R5, #WndVarBuf .SR.PAGE 

R6, #indVarBuf .AN.OFST 

MsgActFlg,SAD11 
WndActFlg, SAD10 


SAD18 


SAD10: 
MOV 
MOV 
SJMP 

SAD11: 
MOV 
MOV 

SAD12: 
LCALL 
MOV 
MOV 
MOV 
SUBB 
INC 

-MOV 
MOV 
MOV 
MOV 
MOV 
LCALL 
CLR 
‘SETB 
MOV 
MOV 
ADD 
MOV 
MOV 


MOVX.. 


INC 
MOV - 


R3, #BgdVarBuf .SR.PAGE 
R4,#BgdVarBuf .AN.OFST 
SAD12 


R3,#MsgVarBuf .SR.PAGE 
R4,#4sgVarBuf .AN.OFST 


BldTrmRcb 

DspWid,#40 _ 

DspHgt ,#7 | 

A,WndCol 

A,VisCol 

A 

ColAdd,A 

RowAdd , #6 

RcbOf f , #WndRCBO.AN.OFST 
ChrOff , #WndChrBuf0.AN.OFST 
AtrOff,#WndAtrBuf0.AN.OFST 
SwpVar 

MsgActFlg 

WndActFlg 

P2,ExtRow 

A,Rcboff 

A,#RCB_RowPag 

RO,A 

A,ExtRow 

aR0,A 

RO 

A,RcbOff 


ba a dt es ee ee ee | 


Extra RCB is now rebuilt 


Make the wnd window aétive 


If wnd window is already active 
do nothing further 


If the background was active 
move its dsp. vars. out 


If the msg window was active 
move its dsp. vars. out 


Update non-moving display vars 


Indicate current active state 
by internal flags 
Set page address to extra row 
Build offset into RCB at 
next row pointer 
Use RO as index pointer 
Next row pointer = ExtRow 


Store it in RCB 


Get index to offset 
Move current rcb offset 
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RO 


@RO,A 
RO 


A, ExtRow 
aRO,A 


A, #WndChrBuf0.AN.OFST 
@RO,A 


“RO 


A: 
@RO,A 
RO 


. ORO,A 
RO 


A, ExtRow 


“ACC.4 
@R0,A 


RO 

A, #WndAtrBuf0.AN.OFST 
@RO,A . 

RO 

A 

@RO,A 


RO 


@RO,A. 

RO 

A, #NrmRRB.SR.PAGE 
@R0,A 

RO 


A, #NrmRRB.AN.OFST 


@RO,A 
SAD18 


=e =e =o me 
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Store it 
Set hidden count 


Store hidden count 
Index to visible count 


‘Visible count is wnd width 


Store it 


No continue bit 


Store always zero byte 


Index to chr ptr page 
Set to char buffer 
Store it in RCB 


- Index to chr ptr offset 
Offset of character buffer 


Stored 
Store empty word in RCB 
Index to atr page 


Build Attribute page 


Store page to atr 
Index to atr offset 


- Store it 


empty word in RCB 


Index to atr page 
Page of normal RRB 
Store it 


Offset .of normal RRB 
Extra RCB is now rebuilt 


@R1,#01H,SAD18 
R5,#MsgVarBuf .SR.PAGE 


_R6,#MsgVarBuf .AN.OFST 


WndActFlg,SAD14 


MsgActFlg,SAD18 


R3, #BgdVarBuf .SR.PAGE 
R4, #BgdVarBuf .AN.OFST 
SAD15 


- R3,#WndVarBuf .SR.PAGE 


R4, #WndVarBuf .AN.OFST 
BldTrmRcb — 


AMDDWMBit ,SAD16 
DspWid, #80 
SAD17 


Dspwid, #120 


Dspligt,, #01 


ColAdd, #01 
AMDDWMBit,SAD17a 
RowAdd , #30 
SAD17b 


RowAdd , #24 


RcbOf f ,#BgdRCBO.AN .OFST 
Chroff ,#8gdChrBuf0.AN.OFST 
AtrOff ,#BgdAtrBuf0.AN.OFST 
SwpVar 

WndActFlg 

MsgActFlg 


R1 
R2 


=e =e =e me 


'Make the Msg window active 


If Msg window already active 
do nothing further | 
_If background was active 
move its dsp. vars. out 


If Wnd window was active 
move its dsp. vars. out 


will be updated 


Update non-moving display vars 


Indicate current active state 
with internal flags 


Test if we are at the end 
of our parameters 


If true get out 
Else proceed with the next 





£o-d 


SAD19: | 
CLR OA If an error was detected 
MOV CtlPtrHi,A remove all traces of this 
MOV CtlPtrLo,A — : control 
SAD20: , 
LCALL PlcCsr Relocate our cursor 


RET 
e 


7? 
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SelCursorAppear: 


e is 
eeanemoecveeneoetseenveneancuaeneonvnnaoneecpeaenveeveneeeeneeoveneceveeneeenseseeneeneseoeneeaeeeetenaeeaane 


: 
; Selects the type and appearance of the cursor. 
. 

; 

; Parameters Meaning 


_ Steady reversed full block, initial - 
Reversed full block 
Reversed block half of character cell 
Solid block half character cell 
Underscore 
Thick underscore 
Steady, non-bl inking 
Blink 50/50 cycle 
Blink 25/74 cycle 
Fastest blink 
Fast blink 
Slow blink 
Slowest blink 


‘inp  PrmCnt ; count of parameters 

PrmBuf , buffer containing the parameters 
out none | 
bad A,RO,R2,R4,R5,R6 


eoaneveenesesan -eesanspeeesnoce eeaneene ees eecvneeveeveesneeuenvnvneoenvoeeocWesensecan enepseaaseenvneenusn 
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‘JNB = PrmBadFlg,SCA1 ; Indicates a bad param buffer 
LUMP SCA20 | ; | ;° error return 


SCAT: 
JNB = PrmMaxFlg, SCA2 : Indicates too many parameters 
LUMP. SCA20 : error return 


RO, #PrmBuf 
A,Prmcnt 
SCA2a 
aRO,A 

A 


R6,A 


ARO, #00, SCA4 
CxybeBit 
ChgBlnkSpd 

R5 ,#06H 
CsrSiz,#00DH 
AMDDWMBit , SCA9 
CsrSiz,#00AH 
SCA9 


RO, #01, SCAS 
R5,#006H 
CsrSiz,#00DH 
AMDDWMBit , SCA9 
CsrSiz,#00AH 
SCA9 


ARO, #02, SCAG 
R5,#06H 
CsrSiz,#06AH 
AMDDWMB it, SCA9 
CsrSiz,#058H 
SCA9 


ARO, #03, SCA7 
R5,#04H 
CsrSiz,#06AH 
AMDDWMBit , SCA9 


‘CsrSiz, #058H 


SCA9 


ARO, #04, SCA8 
R5, #04H 


_ CsrSiz,#0CCH 
AMDDWMBit , SCA9 


3; Initial cursor 


Reversed full block 


Reversed half block 


Solid half block — 


~ 


Underscore 
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CsrSiz,#0AAH CLR CubBit0O 
SCA9- SETB CxybeBit ~ 
SUMP SCA17 
. SCA16: 
ARO, #05 ,SCA10 ; Thick underscore CJNE -aRO,#25,SCA18 ;. Slowest rate 
R5,#04H — | SETB CubBit1 
Csr$iz,#0BCH : : SETB CubBit0 
AMDDWMBit,SCA9 ~ » 3 SETB CxybeBit 
CsrSiz,#09AH . : : SCA17: 
| . LCALL ChgBlnkSpd 

ChgCsrSiz , SCA18: 

ChgCsrTyp . | INC RO 
- SCA18 DEC - R6 

. | MOV 

ARO, #10, SCA11 : Steady non-blinking Jz 

CxybeBit _ -  LJMP 

SCAIT SCA20: 

. | - CLR OA 

@RO, #11,SCA12 . : Blink 50/50 cycle , MOV CtlPtrHi,A 

CxybeBit a | MOV ctlPtrLo,A 

CudBit : . SCA21: 

SCA17 . RET 


. 


@RO,#12,SCA13 ; Blink 25/75 cycle DEH EEE EE 
CxybeBit ; a SmoothScrltRate: . . 

CudBit | | | 

SCA17 


Selects the rate at which smooth scrolling occurs. 


@RO,#20,SCA14 ; ; Fastest rate 
CubBit1 

CubBi tO 

CxybeBit 

SCA17 


=e es =e =e 


Parameters Meaning 


frame 
frame 
frame 


line / pixel / 

line / pixel / 
: line / pixel / 
@RO,#21,SCA15 - - ¢ Fast rate line / pixel / frame 
CubBit1 / 
CubBitO / 
CxybeBit / 
SCA17 / 


line / pixel / frame 
line / pixel / frame 
line / pixel / frame 
line / pixel / frame 
line / pixel / frame 
line / pixel / 2 frames 
line / pixel / 3 frames 


— 


aRO ,#22,SCA16 ; Slow rate 
CubBit1 


bk el i i a ee ee ee ee ee 2 | 
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- 
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PrmCnt 
PrmBuf. 
none 
A,R1,R2,R3 


scan line / pixel / 4 frames 
scan line / pixel / 5 frames 
scan line / pixel / 6-frames 
scan line / pixel / 7 frames” 
scan line / pixel / 8 frames 


count of parameters 
buffer containing the parameters 


‘UB 


JB 


RR 


PrmBadF lg, SSR6 
PrmMaxFlg,SSR6 


R1,#PrmBuf 
A,PrmCnt 
SSRO 
aR1,A 

A 


R2,A 


A, aR1 
SSR4 
R3,A 
c 

A, #09 
SSR3 
A,R3 
ue 
SSR4- 


A,R3 
c 

A, #12 
SSR5 
A,R3 
A, #3 


A 
A 


Indicates a bad param buffer 
error return 

Indicates too many parameters 
error return | 


work on current parameter 
test if in first group of 


parameters 
If true adjust for calculation 


Test if between groups 9-11 


If true exit 
else adjust for calculation 


- work on hi nibble first 
isolate hi byte 





MOV R3,A ; Store for future use 
ANL A,#.NT.SCRL_RAT_MASK ; Mask off unused bits 
JNZ SSR5 


bring in scroll byte © 
Mask balance of byte to write‘ 


MOV A,ScrlByt 
ANL  A,#.NT.SCRL_RAT_MASK 


=e me =e =e 


ORL = A,R3 generate combine Scribyt parts 
MOV ScriByt,A return new value 
SSR5: 
INC R1 
DJNZ R2,SSR1 ; Continue until last parameter ~ 
SJMP SSR7 
SSR6: . 
CLR A. ; If an error was indicated 
MOV CtkPtrHi,A ¢ - remove all traces of 
MOV CtlPtrLo,A : control 
SSR7: 
RET 


SEEEEELEEELEEEEELEEEE ALE EELEEEAEEEEEEEEELEEEEE EASE LEE EEATEEEEEEEEEFEEEE EEE EHH 4+ 
SelWindowVis: 


; Selects window visibliity. 

7 

: 

; Parameters _ Meaning 

7. Pee e®enwmewewe 0 2. -. —. Rm phere owe 

: 0 make window invisible 

7 1 ~~ make window visible 

P 

3; Inp- PrmCnt count of parameters . 

‘ PrmBuf , buffer containing the parameters 
s out none 

; bad R1,R4 

“8 SBeeeeaneae eevreveeneuseeneesneeneenaeeoaenenseevaeseeeseseeeeneseseeneneenaesensevueneeenanaeneeer 


JB = PrmBadFlg, SWV8 - Indicates a bad param buffer 
error return 
Indicates too many parameters 


error return 


JB PrmMaxFlg, SWV8 


s 
a 
s 
g 
s 
a 
s 
a 


JB VrtScrlFlg,$ 
JB HrzScrlFlg,$ 
MOV RO,#PrmBuf. 


50 
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SWV3: 


=e ee me ee =e =e =e =e 
‘ 


‘MOV 
JNZ 

- MOV 
INC 


Swv0:. 


MOV -R4,A 
SW: ; 
' CJNE .aR0,#00, SWV3 : Make window invisible if not taken 
JNB  WndVisFlg,SWV7 — : 
-LCALL HidWnd 
CLR WndVisFlg 
SJMP SWV7 
CUNE @RO,#01,SWV7 ; Make window visible 
JB. WndVisFlg, SWV7 
LCALL ShwWnd. ~ 
‘SETB WndVisFlg 
SWV7: 
INC RO 
DUJNZ R4,SWV1 
LCALL PlcCsr 
RET 
SWV8: | 
CLR A ; if an error was indicated 
MOV CtlPtrHi,A 7 remove all traces of: - 
MOV CtlPtrLo,A : this control . 
RET 


SHEEEEE ELE LETTE EEE EEE EETETE EEE EEE EEE E ETE E ET EEE EE EEE T TEE T TTT E EEE Ett Et tt ttt 


SelMessageVis: 


-Selects message window visibliity. 


=e =e m6 ™=s =a 


Parameters Ag Meaning 


make message window invisible 
make message window visible 


— Prmcnt . count of parameters — 


none 2 
A,R1,R2,R3,R4 


PrmBuf _.. buffer’ containing the parameters. 


PrmBadF lg, SMV11 
_ PrmMaxFlg, SMV11 


vrtSerlFlg,$ 
HrzScrlFlg,$ 
R1,#PrmBuf 
A,PrmCnt 
SMV1 

@R1,A 

A 


R4,A 


EXO 


_ @R1, #00, SMV5 


~ MsgVisFlg,SMV10 


DPTR,#TrmWDB+WDB_BgnRow 
AMDDWMB it , SMV3 

A, #24 

SMV4 


A, #30 


ADPTR,A . - 

DPTR 

QDPTR,A 

MsgVisFlg 
R2,#TrmWDB.SR.PAGE 
WndVisFlg, SMV9 . 
R3,#T rmWDB .AN .OFST 
SMV8 


aR1 , #01, SMV10 
MsgVisFlg, SMV10 


_ DPTR, #TrmWDB+WDB_ BgnRow 


AMDDWMBit, SMV6. 
A, #26 
SMV7 


A, #32 


Indicates a bad param buffer 
Indicates too many parameters 
error return . 


Make méssage window invisible 
if not taken 


Adjust Termination start and 
end row count 


if compressed mode. 


Termination Def. BLk. Ptr 
Window is visible if taken 


Make message window visible ~- 
If msg window is already 
showing just return 


In both normal and compressed 
mode rows: are just after 


Msg row in display 
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MOVX a@DPTR,A 
INC DPTR 
MOVX -@DPTR,A 
SETB MsgVisFlg 
MOV R2,#MsgWDB.SR.PAGE 
JB WndVisFlg,SMV9 
_ MOV’ R3,#MsgWDB.AN.OFST. 
SMV8: ; 
MOV R1,#TOWHrdLoInd ; Write new TOWHrdLo Ptr 
LCALL WrAm8052Reg : 
SJMP SMV10 
SMV9: 
MOV DPTR,#WndWDBO+WDB_NxtPag 
MOV _A,R2 : 
MOVX @DPTR,A 
INC DPH 
‘MOVX @DPTR,A 
SMV10: 
SETB EXO 
INC R1 
DJNZ R4,SMV2 
 LCALL PleCsr 
RET 
SMV11: ; 
CLR A ; If an error was indicated 
MOV CtlPtrHi,A . + pemove all traces of this 
MOV) CtlPtrLo,A- : control 
RET 


SEEEEEEEE EEE EEE EEEEEEE EEE EE EEE EEE EEE EEE EEE TEEPE EEEEEEEEEEEEEEEES EE ETE TE EET 
; end of C_Work 
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Ps 
’ 
; 
a 3 Copyright 1985 Advanced Micro Devices, Inc. 
: 
’ 
; 


48051" 
TITLE " CALEB 0.00 System Utilities" 
FHEEEEEEEEE TELE EEE EEE E EEE E EEE ETAT EEE E ETE E EEE E EEE EET TFET TTT tT ttt ttt tt tPF Ft tt tt 


CALEB 0.00 


A 


This file contains the various system utilities used by the control routines. 


NAME "System Utilities" 
PROG 


SEEEEEEEEEL EEA EEEEEEEE EE EEE EE AEEEEEFE EEE EE EEE EEE EEE EE ETE EEE EEE EE EEE ET EE ETE ET Tt 
GLB) - DlyTilEndFrm,PlcCsr,EraActEnd,EraBgnact, aca aa ChgCsrSiz 
GLB .SetCelWid,ChgCsrTyp 
GLB DelRow MovDn,DelRow | Movup, Hidcsr, ShwCsr 
GLB- InsRow_MovDn, InsRow_MovUp 
GLB WrAm8052Reg,RdAm8052Reg,WrFntCel 
GLB  EraRow, ScrlUpDsp, ScrlDnDsp, Scr LUpNewRow, Scr LRtDsp, ScrlLtDsp 
GLB SetForScrlDn,SetForScrlUp,ScrlLtOne,ScrlRtOne, FrcEraRow 
GLB SetAftSerlDn 
Gl SetWndPos, NewCsr ,HalfSwap, BldTrmRcb, HidwWnd, Shwwnd 


SEEEEEEE EEE EE EEL EEE EAE EEE EE EE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE E EEE ETE t tt ttt ttt ttt 
SKIP... 
INCLUDE C_MemMap 


SKIP 
TELELEEEEEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EE EEE EEE EEE EEE EEE EEE E EE EEE T ETT tt ttt 


DlyTilEndFrm: ; Delay until end-of-frame time starts 
Ensures two character row times of nearly unimpeded processing time. This 
routine works with the timer 0 interrupt to wait until near the end of the 

- frame (28 scan Lines from the bottom). During this end-of-frame time the 
Am8052 is-displaying information it has already fetched and needs the bus 
only twice, each time-to fetch only the termination row control block with 
its single character and single latched attribute. Changes accompl ished 
during this time will not be visible until the next frame starts (at blank 
time.at the bottom of the screen). Thus, there will be no distracting 
interference with the Am8052. 


=e |e B88 =e me =e Se -@e ae 


EndFrmFlg,$ . 
EndFrmFlg,$ 


; Ensure we're in middle of frame 
; Wait for end-of-frame interrupt 
3 Exit 


: SPEER EEREEEEEEEEEE EEE EEE EEE EEE EE EEE EEE EEE EEE EEE 444 44444464464444464444444444444444+ 
FndCsrZon: 


Determines the type of zone (visible or invisible) containing the active 
position. It also calculates the number of columns to the first column 
of the next zone to the right. This value is used to speed advancing the 
cursor following a simple character input. 2 
ActCol active position's column within display 

ActRow active position's row within display 

CsrZonFlg set if cursor is visible, cleared-if invisible 
CsrZonCnt distance to next zone rightward . 
A, RO, PSW 


MsgActF lg, FCZ3 
C 
. A,ActRow ; 7A = # rows down from top 
A, VisRow : of screen 
FCZ5- skip if "above" top of screen 
WndActFlg, FCZ2 :skip if in window 
WndVisFlg,FCZ2 ;skip if window not visible | 
zin background, window visible 
RO,A . 7RO = # screen row 
- A, #WND_TOP_MRG = # rows down in window 
FCZ3 :skip if above top of window 
A, #WND_VIS_HGT = # rows down below. window 
FCZ1 iskip if below window 
-;in background, in window row range 


;skip if in message 


C 

RO, ActCol 7RO = current. column 

A,RO . 7A = # columns right of visible 
A,VisCol ; left side - 

FCz8 ;done if left of screen 
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 A,RO 
-A,WndCol 


FCZ9 . 

A, #WND_VIS_WID 
FCZ8 
A,RO 

FCZ24 


A,RO 


‘A,DspHgt 


FC26 


Cc 
A,ActCol 
A,VisCol 
FCZ8 


- A,DspWid 


FC29 


A,ActCol 
WndActF lg, FCZ7 


x 


A, #WND_BUF WID 
FC28 


A,#BGD_BUF_WID 


CsrZonFlg 
FC212 


MsgActFlg,FCZ10 


MsgVisFlg,FCZ8 


WndActF lg, FCZ11 
WndVisFlg,FCZ8 


;hold visible col in RO 

-A = # cols into window 

sdone if left of window 

sA = # cols right of window 

sdone if beneath window 

-A = visible column 

_ skip to check vs screen right 

sreset A for linkage 

7A = screen row 
z;check if beneath screen 

"A = # rows beneath screen 

:skip if beneath screen 
srow is visible background or message 
scheck if left of screen 


‘A = visible column | 


;done if left of screen 
scheck if right of screen 

*A = # cols right of screen 

:done if visible on screen 
snot in visible screen row 

:buffer widths bound zones 


:A = current column 

:skip if window is not active 
swindow is active 

;zone extends to window end 


;window is not active 
szone extends to buffer end 


scursor is not visible 
:if msg is active check if 
visible, adjust CsrZonFlg 


. accordingly 


do the same for the window 


FCZ11: 
SETB CsrZonFlg 
FCZ12: 
CPL A ;-A 1s zone remaining count 
INC A 
MOV CsrZonCnt,A 
RET 


cursor is visible 


ZEEEEEEEEEELE LEE E TELE EE EEE FEE EF EEE EEE LEE EE EE EE EE EE EEEEEEEEEEE EEE EEE EE EET Ett ttt 
NewCsr: 

# 

Assigns the new active position from the given location and updates the 
current row page address. 


R2 new active row position 
RS new active column position 
ActCol active column position 
ActRow active row position 

CurRow active row page address 
A,P2,RO,R1,PSW 


This routine must be located immediately before "PlcCsr". 


° 
7 
e 
f 
. 
a 
« 
f 
. 
s 
a 
’ 
e 
ri 
. 
’ 
s 
’ 
. 
f 
r 
' 
. 
f 


Ready for comparison below 

Check new active row 

Jump if not at first row 

Get page address of first row 
and go assign new position 

; Determine direction of movement 

Compare new row to old 

Jump if they are the same 

Jump if new is below old 

Start at first row if new is 
above old and count down to 
new row 


A, BgnRow 
_ NC7 


=a =e =e es ma 


A, ActRow 
NC8 
NC2 
P2,BgnRow 
A,R2 
NC3 


=a =e Ge =e =a we 


P2,CurRow ; Count difference from old row 
up for search 

R1,A ; Save number of rows to skip 

A,Rcbof f ; Get offset into active RCBs 

A,#RCB_RowPag ; of next RCB's page address 

RO,A : ready for search 





rset page for main blocks 
;RO -> cursor x, block 0 
7R1 -> cursor x, block 1 


DPH ;#BgdMDBO.SR .PAGE 
RO, #BgdMDBO.AN.OFST+MDB_Cux 
R1,#BgdMDB1.AN.OFST+MDB Cux 


each row skipped 


A, BtmRow,NC5 Jump if row is not bottom vis 


NC6 — 
A, @RO 


P2,A 
R1,NC4 


CurRow,A 
ActRow,R2- 


* 
s 
s 


v 


: 
A,RemRow » Set for remaining rows 
7 


and continue search 
Get next row page address . 


Point to row 
Loop if more to skip 


; Assign new position 


’ 


f 


New current row page address 
New &ctive row position 


C 


‘A, ActCol 


A, VisCol 
A,ColAdd 
DPL,RO 
QDPTR,A 
DPL,R1 


_ @DPTR,A 


RO 


:A = # columns right of visible 


3 left margin 


;A = screen column 


;set the x position of cursor 


sadvance ptrs to cursor y 
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: New row same as old 2 R1 
ActCol ,R3 Oe ; New active column position A,ActRow — -sA = # rows down ¢ron top 
A,VisRow . : of screen 
‘This routine falls through to "PlcCsr" below. © A,RowAdd 
-DPL,RO . | 
@OPTR,A . set the y position of cursor 
DPL,R1 
@OPTR,A 
or hidden (disabled) depending on the type of zone (visible or invisible) 
containing the active position. However, nothing is done if a smooth scroll 
operation jis in progress. . 


This routine falls through to "ShwCsr" below. — 


ActCol active position's column within display 

ActRow "active position's row within display 

BgdMDBO main definition blocks modified 

BgdMDB1 

(see also FndCsrZon) e (none) 

A,DPTR,RO,R1,R2,R3,PSW . (none) 
7 (none) 

This routine must immediately follow "NewCsr" and immediately 


precede "ShwCsr", with "HidCsr" immediately after that. _ This routine must immediately follow "PlcCsr". 


VrtScrlFlg,SC1 Exit if vertical or 
horz smooth scroll going on 
Defer until vertical retrace 


VrtSerlFlg,PC1 | sexit if vert smooth scroll ; 
HrzScrlFlg,PC2 : :skip if-not horz smooth scroll — : HrzScrlFlg,SC1 
; . CsrShwF lg 


FndCsrZon | sneed to recalculate zone 
CsrZonFlg,HidCsr ;jump if cursor not visible 


* 





HidCsr: 


Disables the Am8052 X-Y cursor so that the active position is not marked. 


In: (none) .- 
Out: (none) 


A,DPTR,R1,R2,R3 


Remove cursor for hidden positions 


This routine must immediately follow "ShwCsr". 


‘@eeespaoeaesoennveasenea 


CsrShwFlg 
CsrSetFlg 7 
R1,#ModReg2Ind 
RdAm8052Reg 
A,R2 
ACC.7 
R2,A 
LCALL WrAm8052Reg 
RET 


sebneeaaeaneeavnanesseneaeeee eeeousreneeneaeeeanennvseseveaeneaansne 


Ensure no cursor 


- Need Mode Register 2 
read from Am8052 
Get high byte and 
reset CUE bit to disable the 
X-Y cursor then put it back 
and write it to Am8052 
Exit 


SEEEEEE EEE EEE EET EEE TTT E EET EEE TEEPE FEET TEE E EET E ETE E PETE E ETE ETT ET TESTES TET 


EraActEnd: 


f , : 

: Erases from, and including, the active position through the end of the 
; active row. The erased positions will contain spaces with the current 
: ; 


attribute. . 


A, CurRow 
P2,A | 
| WndActFlg,EAE1 
ACC.4 
R5,A 
A, #40 
EAE2 


ACC.5 
R5,A 
A, #128 


Test if in window or Background 
Build window attribute page ptr 


« max count for window row 


& 


Build Bgd attribute page ptr 


-Max count for background row .- 


A, ActCol 
R6,A 
R7,A 

A, Chroff 
A,ActCol 
RO,A 
A,#' ' 


@RO,A 

RO 
R6,EAES 
P2,R5 
A,Atroff 
A,ActCol 
A,ActCol 
A 


RO,A 


A,CurAtr 


@RO,A 

RO 

RO ; 

R7,EAE4 

P2,#BgdActCntBuf .SR.PAGE 
A,R5 

MsgActFlg,EAE5 

RO, #MsgActCnt.AN.OFST 
EAE8& 


WndActFlg,EAE6 

RO, #WndActCntBuf .AN.OFST 
A, #00FH 

EAE7 

RO, #BgdActCntBuf .AN.OFST 
A, #01FH 


A,RO 
RO,A 


A,aRO 
c 
A,ActCol 
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JC EAE9 | MOV 2, #BgdActCntBuf .SR.PAGE 
- MOV A,ActCol MOV A,R5 
“MOVX @RO,A | JNB  MsgActFlg, EBES 
EAE9: MOV RO, #MsgActCnt.AN.OFST 
RET . SJMP EBE8 
| EBES: 
TEPER EEE EEE EEE EEE EEE LETTE EE EEE TEP EE ETT TEES TE EEE ER TET EEE TEE ETT T TFET TFET . JNB - WndActFlg,EBE6~ 
-EraBgnact: - 8 . . MOV RO, #ndActCntBuf .AN.OFST 
£5 Fei e ty cevedneeman mee eeaae ser aeane Sct Sie ae catate siete aos teeiarwi sae eta ae Siete ANL A, #00FH 
> Erase from, and including, the first position in the active row through the SJMP EBE7 
; active position. The erased positions will contain spaces with the current EBE6: 
; attribute. _ | “ss . MOV RO, #BgdActCntBuf .AN.OFST 
ANL A, #01FH 
EBE7: 
_ A, CurRow ADD A,RO 
P2,A : MOV RO,A 
‘WidActFig,EBA1 | . EBE8: 
ACC.4. | | MOVX A, @RO 
EBA2 | — SETB C 
SUBB A,ActCol 
ACC.5 ihe _ JNC EBES 
. | _ CLR A 
R5,A ; ; — . MOVX @RO,A 
“A, ActCol . _ EBES: 
A RET 
R6,A . . 
R7,A . FEEEEEEE EEE TELE TESA EEE EEE EEE EEE EEE EEE EEE EEE E EE EEE EEE EE EEE E EE ETE FET TEE ttt ttt 
.RO, Chroff FrcEraRow: 
A,#! ‘ : ecm n seen ncceens Serer e TT re Orrrrrerrer rrr th ie eeeccscsccens ‘eaee 


Forces an entire erasure of a row for Erase In Display or Erase In Line. 


. 
a 


’ 
@RO,A ' ; : 

RO ; : This routine must immediately precede "EraRow". 
-R6, EBA3 Gi : 


~ P2,R5 . 
RO,Atroff “ DPH ,#BgdActCntBuf .SR.PAGE 
RO ; MsgActFlg,FER1 
A,CurAtr ; DPL, #4sgActCnt .AN.OFST 
R7, #128 


@RO,A ; | FERG 

RO . . 

RO ie G | . | . WindActF lg, FER2 

- R7,EBE4 a DPL , #WndActCntBuf .AN.OFST 
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MOV R7,#40 
SJMP FERS 
FER2: | 
MOV DPL,#BgdActCntBuf .AN.OFST f 
MOV R7,#128 ; 


FER3: 
ANL A,#01FH 
ADD A,DPL 
MOV DPL,A 
FER4: 
MOV A,R7 . 
MOVX @DPTR,A 
MOV A,R6 


* 


: NOTE: This routine falls through to "EraRow" below. 


EraRow: 

P gseee espn eneaoennowevnnvneaesveeeveaeneweseveaeuvuseeeeneneeteoeseeeeeseeevwneseeecesaeevneaennane @egea@enoeprpnweaeceveenpwnseaeseseeeaeeass 
» Erases the given row to a blank condition (i.e. all spaces with the current 

> attributes). 

- 

: In: A page address of row 

; Out: active count update 

: Bad: A;DPTR,P2,R0,R4,R6,R7 

Fee cere rennet ew seeneseee seexeesenm@enweoeaneceseseeses speseaeevmeaeeaenuage @ee5ueeaeeaessest eweeuseeneGeewenvean 8 


‘;put page address in ptr 
:skip if not msg row 
smessage row 


MOV P2;A 
JNB  MsgActFlg,ER1 


SETB ACC.5 


:R2 = attribute page 
“MOV R4,A . 
MOV DPTR,#MsgActCnt ptr to active char count 
: SUMP ERG - ;do the erase 
ER1: , :check for window 
MOV R4,A sput character page in R2 


skip if not in window 


JNB = WndActFlg,ER2 
: swindow row. ~ 


SETB ACC.4 7A = attribute page 
MOV DPTR,#WndActCntBuf sptr to active character counts 
SJMP ER3 


1l 


ER2: smust be background 


SETB ACC.5 sA = attribute page 
MOV DPTR,#BgdActCntBuf sptr to active character counts 
ER3: 
XCH = =A,R4 ;put attrib page in R2 
CLR ACC.7 sget row number in A 
ADD. A,DPL index DPTR to correct count 
MOV DPL,A ; for this row 
ER4: 
MOVX A,@DPTR ;fetch the active character cnt 
JZ ER7 skip if none : 
MOV R6,A sR6 = R7 = Active count 
MOV R7,A (one for char and one for attr) 
CLR A zsActive count set to 0 
MOVX @DPTR,A 
MOV RO,ChrOff ;RO = offset of first char 
MOV A,#" © sA = blank character 


ER5: sblank characters loop 
MOVX @RO,A sblank one character 
INC RO snext character 
DJNZ R6,ER5 
sdone with character blanking 


MOV P2,R4 zattribute page selected 
MOV RO,AtrOff sattribute offset in RO 
INC RO sselect lower attribute byte 
MOV A,CurAtr scurrent attributes 

ERG: . ° 
MOVX. @RO,A sset lower attribute byte 
INC RO znext attribute 
INC RO 


DJNZ R/,ER6 
;done with attribute clear 


_ER?: 


RET 


SEEEEEEEEEE EEE EE EEE EEE EEEEE EEE E EERE EEE EEE EEE EEE EE EEE ESET EE EEE EEE TEETH ttt tt ttt 


HidWnd: 


; Hides the window if window is visible, if the message window is visible 
; it maintains its visibliity. 
: ; ; 


3 Bad: R1,R2,R3 


89-a° 


JB MsgVisFlg,HW1 

MOV  R2,#TrmWDB.SR.PAGE 

MOV 83, #TrmWDB.AN.OFST 

SUMP HW2 
HWi: 

MOV R2,#MsgWDB.SR.PAGE . 
MOV  R3,#MsgWDB.AN.OFST 
HW2: i . 

MOV R1,#TOWHrdLoInd 

LCALL .WrAm8052Reg 

RET : 


SPEER TEER LETTE EE TEETH EET E FETE F EET E ETE E EEE E EEE ETT E EE ETT E ETT T EEE E EEE E EE ETE 


ShwWnd: 


MsgVisFlg,SW1 
R2,#T rmWDB.SR.PAGE 
R3,#TrmWDB.AN.OFST 
sw2 


R2,#MsgWDB.SR.PAGE 
R3, #MSQWDB.AN.OFST, 


DPTR,#WndWDBO+WDB NxtPag 


A,R2 , 
EXO 

“@DPTR,A 

DPTR 

A,R3 

@DPTR,A 

DPH 

@DPTR,A 

DPL © 

A,R2 

QDPTR,A 

EXO 
CurWDBF lg, SW3 
R2, #WndWDBO.SR.PAGE 


MOV R3,#WndWDBO.AN.OFST 
. SUMP  SW4 . 
SW3: 
MOV R2,#WndWDB1.SR.PAGE 
MOV R3,#WndWDB1.AN.OFST 
SwW4: 
“MOV -R1, #TOWHrdLoInd 
LCALL WrAm8052Reg 
SW5: 
RET 


SEEEEEEEEEE EEE EE EEE EEE EEE EEE EEE EEE EEE EE EEE EEE EE EE EEE EET EEE AT ETE E TTT T TTT TFT ttt tt | 


BldTrmRcb: 


Writes a-new termination row control block when activating a different 


display. 


MsgActFlg,BIR1 


DPTR, #BgdVarBuf+(ExtRow-CurAtr) 


A, aDPTR 
TrmRow, A. 
BTR2 


TrmRow, ExtRow 


_ TrmOf f ,RcbOff 
P2, TrmRow 
RO, RcbOf f 
A, #80H 
aRO,A - 
RO 
RO 
A, TrmRow 
@RO,A 


RO ; 
' A, TrmOff 
@RO,A 

RO 

A 


=e 6M =e 6M =5 =e =e =e 


When the background is to be 


active it must have a 


properly initialized Term. 


this will be the Window dsp: 
ExtRow. 

Termination RCBs point to 
themselves, with a segment 
count of one, a hidden 
count of zero, and a visible } 
count of one. 
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RO 


‘RO 


RO 


RO 

RO 

RO 
A,#TrmAtr.SR.PAGE 
aRO,A , 


RO 
‘A, #TrmAtr.AN.OFST 


@RO,A 


RO” 


A 

ARO, A 

RO 

aRO,A 

RO 

A, #NrmRRB.SR.PAGE 
aRO,A 

RO . 

A, #NrmRRB.AN.OFST 
@RO,A 


. DPTR, #TrmWDB+WDB_RowPag 
- A, TrmRow 


EXO 

ADPTR,A 

DPTR- 

A, TrmOff 

aDPTR,A sw 

EXO 
DPTR,#MsgRCB+RCB_RowOff 
EXO 

@DPTR,A 


* DPL 


A, TrmRow 
aQDPTR,A 
EXO 


- WndActFlg, BTR3 


MsgActFlg,BTR3 
A,BtmRow 
BTR4 


DPTR, #8gdVarBuf+(BtmRow-CurAtr) 
A,@0PTR 


DPH,A ~ 
DPL, #BgdRCBO.AN.OFST+RCB_RowPag 
A, TrmRow ° 


EXO 


QDPTR,A 

DPTR 

A, TrmOff 
QDPTR,A 

EXO 
MsgActFlg,BTR5 
WndActFlg,BTR5 
A, BtmRow 

BTR6 


_DPTR, #WndVarBuf+(BtmRow-CurAtr) 
A, @DPTR 


DPH,A 
DPL,#WndRCBO.AN.OFST+RCB_ RowPag 
A, TrmRow 

EXO 

@DPTR,A 

DPTR 


' A, Trmoff 


QDPTR, A 


* EXO 
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Hal fSwap: 
Copies 


In: 


: 
oe 
; Out: - 
: Bad: 
MOV 
MOV 
MOV 
MOV 
MOV 

HS1: 
MOV 
MOVX 
INC 
INC 

* DJNZ 
RET 


SwpVar: 


In: 


Out: 


Bad: 


e 
a 
e 
’ 
s 
f 
. 
f 
. 
a 
a 
a 
. 
' 
cd 
° 
f 
ry 
g 
« 
f 
e 
id 
ry 
f 


NOTE: 


MOV | 
PUSH 
MOV 
MOV 
MOV 





SEPEEELEEEE EEE EEE LETT TEE ETT TEE ETT E EET E EEE E TEEPE ETT FEET EEE E TTT EEE TEE EET 


display dependent variables to external memory 


R3 - Out going pointer page 


R4 2 ie Out going pointer offset 
external memory at R3:R4 . : 
P2,A,RO,R1,R2 

P2,R3 ;set page register 

A,R4 rset external offset 

RO,A 

R1,#CurAtr ;set internal pointer 


R2,#(DspWid-CurAtr) ;count of dependent var 


;move one byte * 


A,aR1 

@RO,A 

RO next byte 
R1 | _ 
R2,HS1 


SEEEEEEEEE TEE EE LET EEL EET EET ETT EEE ETT T HEE EET T ETE F EET T EEE EET T EEE EET E EEE EEE 


Moves a set of display dependent variables to external storage 
‘then moves in a new set of dependent variables from a another 
external location. 


R3 Out. going pointer hi 


RG ; Out going pointer lo 
R5 - In coming pointer hi 
R6 . In coming pointer lo 


internal display dependent variables 
external memory at R3:R4 


ee L 
P2,RO,R7 
R1 is preserved 
A,R1 save R1 
ACC 
P2,R3- ;set ouput page. 
A,R4 set output offset 


RO,A 









Ri, #CurAtr 
MOV -R7, #(DspWid-CurAtr) 
SV1: 


MOV A, @R1 
-MOVX @RO,A 
INC RO 
INC R1 


DUNZ R7,SV1 


MOV P2,R5 
MOV A,R6 
MOV RO,A 


MOV R1,#CurAtr 
MOV R7,#(DspWid-CurAtr) 
SV2: 


MOVX A, @RO 
MOV R1,A 
INC RO 
INC R1 


DJNZ R7,SV2 


PoP ACC 
MOV R1,A 
RET 









set internal address 





scount of variables 





smove out loop 





;move one byte 





| znext byte 


sdone with move out 
zset input page 
sset input offset 


sset internal address 

zcount of variables 
smove in loop 

smove one byte 


snext byte 


; done 
srestore R1 


SHEFF EEE ESTEE EEE EEE EEE EE EEE EEE EEE EE EEE EET EE EE EEE EEE EEE EEE EEE TEEPE EEE EE ETE 


-‘SetCelWid: 


pee eensevneeneet SERUTEEEETE TTT 


Sets the upper attribute byte for all positions thus changing the character 


widths uniformly. 


Out: all attributes 
R1 
Bad: P2,R0,R2,R3 


: 

: 

' 

3; In: A- 
; 

; 

, 


MOV R1,A 
MOV P2,#BgdAtrBuf0.SR.PAGE 
MOV R2,#32 

SCW1: 


MOV RO, #BgdAtrBuf0.AN.OFST 
MOV .R3,#128 


Pa 


upper attribute byte 
(upper byte only) 
set to this byte 


sset R1 to attribute byte 
;bacground start page 
3731 backgrd + msg rows 
;bgrd and msg row loop point | 
. sattribute offset 
;character count 
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TZ-d © 


SCW4: 


MOVX 
INC 
INC 


DJNZ 


INC 
DUNZ 


MOV 
MOV 


SCWe: 


* MOV 
~.MOV 


SCW3: 


SEREEEEE EEE EEE EEE EEE EEE EE EEE EEE EE ETE EE EET EEE EEE EEE EEE E ETE T FTE EEE Et ttt tt tt tt 


ChgBlnkSpd: 


e 
’ 


e 
a 
e 
cf 
. 
’ 
. 
f 
e 
ao 
« 
# 


SHELEEEEEEEEEEA EEE EE EEE EE EEE E ETE EEE EEE TEE E EEE EE EET ETE T ETT E TEEPE EEE ttt ttt 


MOVX 
INC 

“INC 
DJNZ 


INC 


~ puNz 


RET 


Changes the blink rates for the cursor and blinking character attribute. 


In: 


@RO,A 
RO 

RO 

R3, SCW4 


P2 


R2,SCW1 


P2,#WndAtrBufO.SR.PAGE 
R2, #15 


RO, #WndAtrBuf0.AN.OFST 
R3, #40 


@RO,A 
RO 
RO 


R3, SCW3 


P20 
R2, SCW2 


BlnkByt 
(none) 
P2,R0,R1,A 


A, BlnkByt 
DPTR, #8gdMDBO+MDB_BLnk 
@DPTR,A 
DPTR, #8gdMDB1+MDB_BLnk 


MOVX ‘@DPTR,A 


RET 
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;bgrd_and msg char loop point 


_;set attribute byte 


sdone 


;done 


snext attribute 


with row 


next row 

with bgrd and msg 

;Window start page 
zswindow row count 


Swindow row loop point 


s;attribute offset 


_ character count 
;window character loop point 


sdone 


;done 


;set- attribute byte 
snext attribute 
with row 


snext row 
with window 


new blink control byte 


sreplace blink control 


ChgCsrSiz: 


Translates the internal cursor size representation (in the form of 2 
nibbles) to the row redefinition block representation of two five-bit 


fields stored in a 16-bit word; 


CsrSiz 


variable defining new size 


normal row redefinition block cursor bytes 


A,P2,RO,R1,R2 


DPTR,#NrmRRB+RRB_Cursii 
A,CsrSiz 

A, #0FH 

R2,A 

A,CsrSiz 

A 

R1,A 

A,#001H 


_@DPTR,A 


DPL 


~ A,RI 


A, #0E0H 
A,R2 
@DPTR,A 


sset rwo redef location 
3;R2 = cursor end 


2R1 = CsrSiz rotated left 1 


smost sig cursor start bit 
swritten in high byte 

snext byte s 
supper three bits of start in A 


scursor end joined in 
swrite lower byte 


SEELEEEELEE EEE EE EEE EEL ESHEETS EEE EEE EET ESE TET T TET TET TFT ttt ttt ttt ttt tt ttt ttt 


ChgCsrTyp: 


In: 
Out: 


me me =e me es Lz) 


R5 
Mode Register 2- 
A,R1,R2,R3 


R1 ,#ModReg2Ind 
RdAm8052Reg 
A,R2 

A, #OF9H 

A,R5 

R2,A 


cursor ‘type bits (bits 1 and 2) 
bits 9 and 10 modified 


smode register 2 index 


shigh byte of mode register 2 
skeep all but bits 1 and 2 
sget these from R5 

swrite it back 





éL-d 


LCALL WrAm8052Reg 


RET 


s 


SAEEE ELTA TFET EE ES TFET EEE E EEE ETE EEE EEE E EEE EE EEE E TEE E EEE EEEEEE EEE TEEPE Ett 
roe . 


DelRow_MovUp: 


MOV. 


LCALL 


. MOV 
ADD 
MOV 
MOV 
MOV 
CLR 
MOVX 
INC 
MOV . 

“ MOVX 
MOV 
‘MOVX 

~ DEC 

_ MOVX 

- SETB 
MOV | 
MOV 
CJNE 

- MOV: - 
MOV 


DRMU1:. . 


MOV 
CJUNE 
MOV 
MOV 
MOVX 
MOV 
MOV 
MOV 
CUNE 
/SJMP 
DRMU2:. 
MOV 
/MOVX 


> 


A,ExtRow 
FrcEraRow 
A,Rcboff 
A, #RCB_RowPag 
DPL,A 

A, ExtRow 
DPH,A 
EXO 
@DPTR,A 
DPL 
A,Rcbof f 


-@DPTR,A ~ 


DPH, EndRow 
@DPTR,A 
DPL 

A, ExtRow 


_@DPTR,A 


-EXO 

EndRow,A 
A,DPH 

A, BtmRow, DRMU1 


_A,EndRow 


RemRow,A 


A, BgnRow 

A, CurRow, DRMU2 
ExtRow,A 
DPH,A - 
A,@DPTR 
BgnRow,A 
CurRow,A 

A, ExtRow 


A, TopRow,DRMUD5. 


DRMU7 


DPH,A 
A,@0PTR 


Erase extra row 


.; Make extra row point to itself 


Le | me =e =e me 


Make end row point to extra row 
thereby adding extra row to 
end of display 


Extra row becomes new end row 
Compare old end row to bottom 
visible row, jump if differ 
New end row 
is also new remaining rows 


: Bottom row not at end of display 


=e =e us =n =e =n as =e =s =e 


Start at first row of display 
Jump if not. currently at begin 
New extra row is old begin row 
Point to it 

and get row following it 

as new first row of display 

and new current row 

Compare old begin row to top 

visible row, jump if differ 
Else handle non-critical cases 


; Current row not at top of display 


a 
ti 
. 
td 


Point to row 
and find row following it 


A, CurRow, DRMU4 


ExtRow,A 
A, BtmRow, DRMU3 
A,RemRow 
BtmRow,A 
CurRow,A 
EX0 
@DPTR,A 
DPH,A 
A,@DPTR 
RemRow,A 
A, TrmRow 
@DPTR,A 
DPL 
A, TrmOff 
@DPTR,A 
EXO 


R6,DPH 
DPH,A 

A, @DPTR 
DPH,R6. 
@DPTR,A 
CurRow,A 
A,ExtRow 
DRMU6 


A, BtmRow, DRMU2 
A,RemRow 
A, CurRow, DRMU2 
ExtRow,A. 
DPH,A 

A, @DPTR 
RemRow,A 


A, QDPTR 


DPH,A 
A, TopRow, DRMU10 


=e =e =e Se 
; f 


, 
=e Ss Se Me BSE we 


. 
& 
. 
a 
s 
s 
e 


a 


Jump if not current row 


Old curr-row is new extra row 

Jump if not at btm visible row 

Special case at bottom, old. 

remaining row to new bottom 
and new current rows 


Make row before bottom point 
- to new bottom (i.e. old | 
' remaining row) and following 
‘row becomes new rem row ; 
Make new bottom row point 
to termination row 


Exit 


; Current row found, not at bottom 


Following row is 
new current row 


Change linked list to delete 
Assign. new current row 
Set up to- : 

scan rest of list 


; Current row not found yet 


; Adjus 


e 
az 


e Se Se &@s Ss Ge Se Ss 


Jump if not at bottom visible 

Compare old remaining row 
to current, jump if differ 

Old curr row is new extra row — 

Point to it — 
‘and following row 
‘Is.new remaining row 

Exit after special case 

t rest of linked list 

‘Get following row — 


- Point to following row 


Jump if not top visible row 
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DRMU7: 
MOV | 
MOVX 
MOV 
JNB 
MOV 
MOVX 
MOV 
MOVX 


SJMP. 


DRMU8: 
MOV 
MOVX 
MOV 

_ MOVX 


DRMU9: 


MOV 
MOV 
~ . SJMP 
DRMU10: 
CJNE 
' MOV 
MOV 
CLR 
MOVX 
INC 
MOV 


MOVX 


MOV 
MOV 

-MOVX 
DEC. 
MOVX 
MOV 
MOV 


MOVX’' 


SETB 
RET 


DRMU11: 
CJNE 


RET 


R7,DPL 

A, @0PTR 

TopRow,A 

WndActF lg, DRMUS — 
DPTR, #WndWDBO+WDB_RowPag 
@DPTR,A 

DPTR, #WndWDB1+WDB_RowPag 
QDPTR,A . 
DRMU9 | 


DPTR,#BgdMDBO+MDB_RowPag 
@DPTR,A 
DPTR, #BgdMDB1+MDB_RowPag 
QDPTR,A 


DPH,A 
DPL ,R7 
DRMUS 


A, BtmRow, DRMU11 
A,RemRow 
BtmRow,A 

EXO 

aDPTR,A 

DPL 

A,RcbOff 
@DPTR,A 


_ DPH, RemRow 


A, TrmOff 
‘@DPTR,A 

DPL. . 

A, @0PTR 

RemRow, A 
A, TrmRow 
@DPTR,A 

EXO : 


_A, EndRow, DRMUS 


. 
f 
ry 
’ 
s 
’ 


e 
f 
. 
f 
s 


Adjust new top visible row 
, and make appropriate block 
(MDB or WDB) point to it - 


Set up to 
— scan through and 
adjust rest of linked list 


; Scanning, not at top 


e 
& 
. 
a 
. 
g 


Jump if not bottom visible row 
Old remaining row is 
new bottom visible row 


Make old bottom row point to 
old remaining. row 


Make new bottom row point to 
termination row 


Row following old remaining row 
is new remaining row 


Exit 


; Scanning, not at top or bottom 


s 
r 


Jump if not at end row © 


Exit when we get to the end 


; EEEEEEEEEEEEEEEEEEEEEEEE EEE EEE ES EEEEEEE EEE EEE EEEEEE EEE EEE EEE EEE TEESE EEE EEE 


DelRow_Movdn: 


Deletes the current active row from the display and moves rows above it 
downward. An erased row is inserted at the top of the display. 


CurRow, BgnRow, TopRow, 
- BtmRow, RemRow, EndRow, 
ExtRow 


A,DPTR,R6,R7,PSW. 


A, ExtRow 
FrcEraRow 
DPH, ExtRow 
A,Rcboff 

~ A, #RCB_RowPag 
DPL,A 
A,BgnRow 
aDPTR,A 
DPL 
A,Rcbof f 
@DPTR,A 
DPL 
A,DPH 
BgnRow,A 


DPH,A 
A,@DPTR 
A, TopRow,DRMD4 
TopRow, DPH 
R6,A 
R7,DPL 
- A,DPH. 
WndActFlg,DRMD2 
DPTR, #WndWDBO+WDB_RowPag 
@DPTR, A 
DPTR, #WndWDB1+WDB RowPag 
@DPTR,A 
DRMD3 


row variables 


updated row variables 


s 
fi 
s 
g 
e 
& 
s 
? 
s 
e 
s 
a 
° 
Fi 
e 
’ 


s 
rd 
e 
e 


Extra row is. 
erased and 
then its 
RCB next 
row field 
is set so the 
old beginning row 
follows it 


Old extra row x 
becomes new beginning row 


each row above top visible row 


=e =e =e =e =e =e =e GE =. =e me =a me 


Point to the row 

Get page of next row 

Jump if next is not top row 

New top row is preceding row 

Save next row page address and 
display's offset to next row 


"This row is new top row 


Jump if not in window 

Point into first window block 
and set new top row 

Point into second window block 
and set new top row 

Continue 
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DRMD2: 
MOV 
MOVX 
MOV 
MOVX 

” DRMD3: 
MOV" 
MOV 
MOV 
SUMP 

DRMD4: 

CJUNE 

_ SJMP 

~ DRMDS: . 
MOV 
MOVX 
CUNE 

* MOV 
CUNE 
MOV 
MOV 
CJUNE 
MOV 

MOV 

DRMD6: 
MOV 
CLR 
-MOVX 

INC 
MOV 
MOVX 
_ SETB 
RET 


DRMD7: 
MOV 
MOV 
CLR 
MOVX 
INC 
MOV. 
MOVX 
~ MOV 


DPTR,#BgdMDBO+MDB_ RowPag 
@DPTR,A 
DPTR,#BgdMDB1+MDB_RowPag 


‘@DPTR,A : 


DPH,A 
DPL,R7 
A,R6 
DRMD8 


A,CurRow,DRMD1 
DRMD11 


DPH,A 

A, a@DPTR 

A, BtmRow, DRMD8& 
BtmRow,DPH 

A, CurRow,DRMD7 
CurRow,DPH 
ExtRow,A 

A, EndRow, DRMD6 
EndRow,DPH . 


_ RemRow,DPH 


A, TrmRow 
EXO - 
@DPTR,A 
DPL 
A, Trmoff 
@DPTR,A 
EXO 


DPH,A 

A, RemRow 
EXO 
@OPTR,A 
DPL 
A,Rcboff 
@DPTR, A 
RemRow, DPH 
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a 


+ Stil 


For 


=e =e Se a 


. 
e 
s 
Ff 
. 
Ff 
. 
e 
l 


° 
, 
« 
f 


Point into first bgd block 
and set new top row 

Point into second bgd block 
and set new top row - 


Point to this row's next 
row pointer again 
Restore page of next row 
Go check for row to delete 
above top visible row 
Loop if not row to delete 
Go delete row 


each row between top and btm vis 


=e =e =e =e =a =e =a we me =e 


Point to the row 


Get page of next row 


Jump if next is not bottom row 
New bottom row is preceding row 
Jump if next is not row to del 
New current row is preceding 
New extra row is one to delete 
Jump if next is not end row 
New end row is preceding .row 
New remaining row is set same 


» Delete old bottom row 


’ 


mus =e. se =e 


Make new, 


bottom row 
point to 
display's © 
termination row 


Exit 


: New btm row (haven't found del row) 


. 
f 
. 
f 


e 
a 
s 
ze 
. 
a 
. 
f 
. 
if 


Make 
‘old -bottom 


row point 
to old 
remaining 
row 
New rem row follows new btm row 


MOV 
MOV 
MOVX 
DEC 
MOV 
MOVX 
SETB 

~ MOV 
SJMP 

DRMD8: 
CJNE 
SJMP 

DRMD9: 
MOV 


MOVX, 


CUNE 
MOV 
MOV 

MOV 
MOV 
MOVX 
RET 


DRMD10: 
CJNE 
DRMD11: 
MOV 
MOV 
MOV 
MOVX 
MOV 
MOVX 

~ RET 


\ 


DPH, BtmRow 
A, TrmOff 
@DPTR,A 
DPL 

A, TrmRow 
aDPTR,A 
EXO 
A,RemRow 
DRMD9 


A, CurRow,DRMD5 
DRMD11 


DPH,A 

_A, @DPTR 

“A, EndRow,DRMD10 
CurRow,DPH 
EndRow,DPH 
ExtRow,A 


_ A,DPH 


@DPTR,A 


A, CurRow,DRMD9 


CurRow,DPH 
ExtRow,A 
DPH,A 

A, @DPTR 
DPH, CurRow 
aDPTR,A 


=e =. ™e =e’ “Me wae 


=e “se Se we Ws Se we Be we 


Still 


e 


Make new 
bottom row 
point to 

-display's 
termination 
row 


Resume with new remaining row. 
and go check for row to del 

between top and btm vis rows 

Loop if not row to delete © 

Go delete row 

bottom visible row 

Point to the row 


Get page of next row 


Jump if next is not end row 
New current row is preceding 
New end row is preceding row 
New extra row is one to delete 
Make end row 

point to itself 
Exit: 


not to end row 
Loop if not row to delete 


Delete row (no special updates) . 


« 
f 
e 
’ 
« 
’ 
s 
f 
s 
F 
. 
f 
= 
’ 


New current row is preceding 
New extra row is one to delete 
Get 
page of following row 
New current row points to row 
after old current (deleted) 
Exit 


SFEEERETEEEE EEE EEE EEE E EEE EEE ETAT T EEE EEE EEE E EEE EE EEE EEE EEE TEE E EEE 


InsRow_MovUp: 


MOV 


A, ExtRow 


LCALL FrcEraRow — 


MOV 
MOV 
ADD 
MOV 


DPH, CurRow 

A, RcbOff 

A, #RCB_RowPag 
DPL,A 





MOVX 
MOV 
INC 
MOVX 
MOV 
MOVX 
DEC 
MOV 
MOVX 
MOV 
MOV 
MOV 

. CUNE. 
MOV 
MOV 
CUNE 
MOV 
MOV - 
JNB 
MOV 
MOVX 
MOV 
MOVX 
RET 
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IRMU1: 
MOV 
MOVX 

- MOV 
MOVX 
IRMU2: 
RET 


IRMU3: 
"MOV 


- MOVX 


MOV 
_ MOV 
CUNE 
MOV 


MOV - 


SJMP 
IRMU4: 
_ MOVX 


A, @DPTR 
R6,A. 

DPL . 
A,@DPTR 
DPH, ExtRow 
@DPTR,A 
DPL 


- A,R6 


@DPTR,A 
R5,ExtRow 

A, BgnRow 
ExtRow,A 

A, CurRow, IRMU3 
CurRow,R5 
BgnRow,R5 | 
A, TopRow, IRMU2 
TopRow, R5 

A,R5 


— WndActFig,IRMU1 


DPTR,#WndWDBO+WDB_RowPag 
@DPTR,A 
DPTR,#WndWDB1+WDB_ RowPag 
@DPTR,A 


t 


DPTR,#BgdMDBO+MDB_RowPag 

@DPTR,A 

DPTR,#BgdMDB1+MDB_RowPag 
-@DPTR,A 


DPH,A 

A,@DPTR 
BgnRow,A — 
A,DPH 

A, TopRow, IRMU4 
R6,A - 
R7,DPL 

IRMUS 


A,@DPTR 


MOV 
CJNE 
MOV 
MOV 
CJNE 
MOV 
SJMP 
IRMUS: 
MOVX 
IRMU6: | 
MOV 
JNB 
- MOV 
MOVX 
MOV 
MOVX 
SJMP 


IRMU?: ~ 


MOV 
~ MOVX 
MOV 
MOVX 
IRMU8: 
MOV 
MOV. 
MOV 
SJMP 


‘TRMU9: 


CJNE 
SUMP 
IRMU10: 
MOVX 


MOV — 


CJNE 
CJUNE 
MOV 
CJNE 
MOV 
SJMP 
IRMU11: 
MOV 
MOV 
CLR 


DPH,A 


A, TopRow, IRMU9 
R6,A 

R7,DPL 
A,CurRow, IRMU5 
A,R5 

IRMU6 


A,@0PTR 


TopRow,A 
WndActFlg,IRMUZ 
DPTR,#WndWDBO+WDB_RowPag 
@DPTR,A 


_DPTR,#WndWDB1+WDB_RowPag 


@DPTR,A 
IRMU8 


DPTR,#BgdMDBO+MDB_ RowPag 
@DPTR,A 
DPTR,#BgdMDB1+MDB_ RowPag 
@DPTR,A 


DPH,R6 
DPL,R7 
A,R6 


“I RMU13 


A, CurRow, IRMU4 
IRMU17 


A,@DPTR 

DPH,A 

A, BtmRow, IRMU13 
A, CurRow, IRMU11 


— BtmRow,R5 


A, EndRow, IRMU17 
RemRow, R5 
IRMU15a 


A,RemRow 
BtmRow,A 
EXO 





MOVX @DPTR,A a ‘MOV A,RcbOff 
INC DPL : ' MOVX @DPTR,A 
MOV A,RcbOff . , SETB EXO 
MOVX @DPTR,A . . | “RET 
MOV DPH,RemRow 
MOV A, TrmOff . EEE EE EEE HEHEHE HEHEHE HEHEHE EEE EEE EEE HEHEHE EEE EEE 
MOVX @DPTR,A | : . “| InsRow_MovDn: | | 
DEC - DPL 
MOVX A,@DPTR ; MOV A,ExtRow 
MOV: R6,A ) . & LCALL FrcEraRow | 
MOV A, TrmRow . MOV ‘R5,ExtRow 
MOVX @DPTR,A — : MOV DPH,RS5 
SETB EXO a = MOV . A,RcbOff 
MOV A, RemRow. | _ MOV R7,A 
CJNE A,CurRow, IRMU12 ; “ADD =A, #RCB_RowPag 
MOV RemRow,R5 . a “MOV -DPL,A 
MOV CurRow,R5 ; . MOV. A,CurRow 
RET | ee MOVX @DPTR,A 
P INC DPL 
IRMU12: | a MOV -A,R7 | 
MOV RemRow,R6 . - MOVX. QDPTR,A 
MOV  DPH,R6 DEC DPL ! 
MOV A,R6 -MOV A,BgnRow 
SUMP ~IRMU15 | = CJNE A,CurRow, IRMD1 
IRMU13:  - . : . MOV = BgnRow,R5 
‘CUNE -A,CurRow,IRMU10 . SJMP IRMD4 
— SJMP so IRMU17. | . ~ TRMD1: | 
-IRMUI4: . : MOV DPH,A 
MOVX A,@DPTR MOVX A,aDPTR 
MOV DPH,A~ .  CJNE A,CurRow, IRMD3 
IRMUISs - | : | MOV R6,A 
-- CUNE A,EndRow,IRMUI6 | MOV A,RS 
IRMU15a: : MOVX @DPTR,A 
‘MOV EndRow, R5 SJMP IRMD4 
SJMP IRMU17 | a IRMD3: | 
IRMU16: CJNE A,BtmRow, IRMD1 
CJNE . A,CurRow, IRMU14 . MOV A,RemRow 
IRMUI7: | | . CJNE A,CurRow, IRMD1 
“MOVs A,R5 | - MOV RemRow, R5 
MOV -CurRow,A ~ pe _IRMD4: . . 
CLR EXO | : | MOV CurRow,R5 
MOVX @DPTR,A MOV A,R5 
INC. DPTR 


9L-d 
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IRMD5: —- “2 A, | IRMD11: 
MOV DPH,A . | | MOV DPH,A 
» MOVX A, @DPTR 3 MOV A, RefiRow 
CJNE A;TopRow, IRMD8& CLR — EXO 
MOV  TopRow,DPH | MOVX @DPTR,A 
MOV R6,A. INC DPL 
MOV R7,DPL° . MOV A,Rcboff 
“MOV A,DPH - | . MOVX @DPTR,A 
JNB  WndActFlg, IRMD6 | MOV RemRow,DPH 
MOV DPTR,#WndWDBO+WDB_RowPag - s MOV DPH,BtmRow 
MOVX @DPTR,A ‘ MoV A, TrmOff 
MOV DPTR,#WndWDB1+WDB RowPag . | | MOVX @DPTR,A 
MOVX @DPTR,A | DEC PL 
SJMP IRMD7. _— ‘MOV A, TrmRow 
IRMD6:° | MOVX @DPTR,A 
MOV DPTR,#BgdMDBO+MDB RowPag SETB EXO 
_MOVX @DPTR,A . . MOV DPH, RemRow 
‘MOV DPTR,#BgdMDB1+MDB_RowPag MOVX A,@DPTR 
- MOVX @DPTR,A IRMD12: 
~ IRMD7: . CJNE A,EndRow, IRMD5 
MOV DPH,A . IRMD13: 
MOV DPL,R7 ' @ MOV EndRow, DPH 
MOV A,R6 MOV ExtRow,A 
SUMP IRMDS a a MOV A,DPH 
IRMD8: MOVX @DPTR,A 
CUNE A,BtmRow, IRMD12 | RET 
IRMD9: Se 

MOV BtmRow ; D P H i 2 : 7 FEEEEEEEEEEEEEE TEETER EEE EEE ETE E EET ETE ETE TE TFET ETE T FETT T ETT ttt ttt ttt tt tt ttt ttt 
CJNE A,EndRow, IRMD11 = Scr lUpDsp: 

IRMD10: : a | 
MOV RemRow, DPH 
MOV EndRow, DPH 
MOV ExtRow,A 
‘MOV A,TrmRow — 
CLR EXO 
MOVX @DPTR,A- 
INC  DPL’ 

MOV A, TrmOff 
MOVX @DPTR,A 
SETB EXO 

RET 


e 
a 


Scroll the display upward the given number of rows. 


In: A number of rows to scroll 
Out: VrtScriFlg vertical scroll flag 
SwbBit window/bgrd scroll flag 
SudBit up/down scroll flag 
VrtScriCnt smooth scroll row count 
‘main and window def blocks top row page and smooth scroll ctrl 
DPTR,P2,A,RO,R4,R7 


=e Se Se Se Be BM elUhMHlUMlUh CU 


MsgActFlg,SUD1 smessage area does not scroll 
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SUD 1: 
MOV 
JB 


JB 


R7,A 
AMDSCMBit, SUD4 


VrtScrlFlg,$ 


LCALL HidCsr 


SUD2: 


LCALL SetForScrlUp 


’ DJNZ 


R7,SUD2 


-LCALL PleCsr 


MOV 
JNB 


MOV 
MOVX 
INC 
MOVX 


RET 


SUD3: 
MOV 
MOVX 
MOV 
MOVX 
RET 

SUD4:: 
JNB 
JB. 
JB 


JB 
JB 
SUD7: 


A,R4 


- WndActFlg,SUD3 


DPTR, #WndWDBO+WDB_RowPag 
@DPTR,A - 

DPH: 

@DPTR,A 


* DPTR, #BgdMDBO+MDBRowPag 


@DPTR,A 
DPL,#BgdMDB1.AN.OFST+MDB_RowPag 
QDPTR,A | 


WndActFig,SUD5 . 
SwbBit, SUD6 
VrtScrlFlg,$ 
SwbBit 
SUD7 


SwbBit ;SUD6 
VrtScrlFlg,$ 
SwbBit 

SUD7 


‘SudBit, SUD8 


VrtScrlFlg,$ 


SETB SudBit. < 


SUD8:- 
-LCALL HidCsr 
MOV A,R7 


save scroll count 

:skip if smooth scrool 

scroll 

wait for scroll in progress 
scursor hidden while scrolling 
SetForScrlUp R7 times 


sput the cursor back 
;A = top visible row 
sskip if not window 


sscrolling in window 


;set DPTR to point to one WDB 
zrow page is top visible 
snow the other WDB 


z:scrolling in background 


zset DPTR to main def first row 
_pset this to top visible page 
srepeat for second main def 


zsmooth scrolling 


zskip if not in window 

sskip if scrolling in window now 
swait for scroll in progress 
sset flag for scroll in wnd 
sinitiate scroll 


ssmooth scrolling in background 


sskip if scrolling in bgrd 
swait for scroll in progress 
sclear flag for scroll in bgrd. 
sinitiate scroll , 


sscroll in progress 


;skip if scrolling up in ae 

swait for scroll down in prog 
sinitiate scroll 

indicate scrolling up 


zadd to scroll count 


scursor hidden while scrolling 
srestore requested scroll count 


ADD A, VrtSerlCnt 

MOV VrtScriCnt,A. 

JBoss WrtSerlFlg,SuD11 

JNB  CurMDBFlg,SUD9 

MOV RO,#BgdMDB1.AN.OFST+MDB Scrl 
SJMP SUD10 


‘s:get new total vert scrl count 


iskip if scroll-in progress 
:skip to select current MDB 
sMDB1 if flag was set 


“SUD9: 


MOV RO, #BgdMDBO.AN.OFST+MDB Scr 
SUD 10: , 
MOV P2, #8gdMDBO. SR. PAGE 
MOV A,ScriByt _ 
SETB ACC.0 
MOVX @RO,A 
—JNB ss VrtSerlFlg,$ 
SUD11: 
RET 


;MDBO if flag was clear 


zbackground MDB page’ in P2 
“sset the scroll byte in MDB 


swait here for scroll to start 


- SEEPS EEE Ett ttt ttt ttt ttt ttt ttt $444-44-4-4-4444444444444444444 
SetForScrlUp: . 

Sets the vertical ‘scroll row variables for a gerout up. This routine may 
be called from an interrupt handler. 


(none) 

R4 top visible row 
VisRow incremented 

row control blocks threading changed 
TopRow advanced via. thread 
BtmRow changed to old RemRow 
RemRow advanced via thread 


VisRow ; ;move the top visible down 
A,Rcboff ;DPL = offset of the field in the 
A,#RCB_RowOf f . row control block which 
DPL,A : points to offset of next RCB 
DPH, BtmRow ;DPH = bottom row page 

A,Rcboff ;A = offset of row control block 


EXO 
@DPTR,A 
DPL 


-A,RemRow 


7no, 8052 access for a moment 
set offset of next RCB_ 

;Now point to page of next RCB 
;set page to rows remaining 
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MOVX @DPTR,A 

MOV - BtmRow,A 

MOV DPH,A 

CUNE A,EndRow, SFSU1 
SUMP SFSU2 


SFSU1: 


MOVX A,@DPTR 


SFSU2: 


MOV RemRow,A 
MOV A, TrmRow 
MOVX @DPTR,A 
INC DPL 

MOV A, TrmOff 
MOVX- @DPTR,A 
SETB EXO 

DEC ODPL 

MOV DPH, TopRow 
MOVX A,@DPTR 


MOV TopRow,A 


MOV R4,A 
RET 


: ‘beneath bottom 


:first of old rem is new bot 
sset DPTR to new bottom 


sfetch page of following row 
;this is new remaining row start 


sset bottom RCB ptr to 
: termination RCB 


’ 


scan allow 8052 access now 
;set DPTR to top row RCB 


sold next row is new top row 


sreturn new top row 


SHELELEL EEL EEE ELLE EEE EEE EEE ETAT TEESE EE EEF TEEPE EEE EEE EEE T TFET ETT T TTT TET FT tt Ft t 


Scr lUpNewRow: 


Scrolls the entire display up one row, inserting a blank row at the bottom 
and deleting the row at the top. Either a jump scroll or a smooth scroll 


is done; depending on the Scroll Mode. 


JNB » MsgActFlg, SUNR1 
RET 


SUNR1: 


MOV A,ExtRow 


LCALL EraRow 


MOV A,RcbOff 

ADD A,#RCB_RowPag 
MOV RO,A 

MOV A, EndRow 

CJNE A,BtinRow, SUNR2 
MOV A,ExtRow 

MOV = EndRow,A 


sno scrolling in message row 


4 


a 


zerase the extra row 


:RO = offset of next RCB offset 


scheck if last RCB is bottom 
skip if not 

z;if so, make the extra 

: the new last row 


f 


RemRow, A 
SUNR3 


“P2,EndRow 


A,Rcbof f 
RO 

EXx0 
@aRO,A 
RO 
A,ExtRow 
@RO,A 
EXO 


EndRow,A 


VisRow 
AMDSCMBit, SUNR5 
VrtScrlFlg,$ 
HidCsr 
SetForScrlUp 
PicCsr 

A,R4 

WndActFlg, SUNR4 


DPTR,#WndWDBO+WDB_RowPag 


—@OPTR,A 


DPH 
@DPTR,A 


" SUNR12 


DPTR,#BgdMDBO+MDB_RowPag 
@DPTR,A 
DPL,#BgdMDB1.AN.OFST+MDB RowPag 
@OPTR,A 

SUNR 12 


WndActFig, SUNR6 
SwoBit, SUNR7 
VrtScrlFlg,$ 
SwbBit 


SUNR8 


SwbB it , SUNR7 


36 


and thus a remaining row 


RCB is not bottom 
3;P2 is current end row 
sA = row control block offset 


sno 8052 access for a moment 
sset offset in old end row 
;set page in old end row 

; to point to extra row 


58052 access OK now 
sextra row is new end row 


skip if smooth scroll 

swait for scroll in progress 
z:cursor hidden while scrolling 
scan now set for scroll up 
sand replace curser 

;A = top row page 

3skip if in background 
scrolling in window 

set top row in one window 

: definition block 0 _ 
snow other WDB 


smake new extra row 
scrolling in background 
z;set top row in main 

: definition block 0 
srepeat for main definition 
: block 1 

zsmake new extra row 


:skip if scrolling in background 


ssmooth scrolling in window 


sskip if window scroll in prog 
swait for scroll in progress 
;set scrolling in window flag 


ssmooth scrolling in background 


skip if bgrd scroll in prog 
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SUNR9: 


JB 
JB 


SUNRS: 


SETB 


LCALL 
INC 
JNB 

~ MOV” 
~ SJMP 

SUNR10: 

MOV 

SUNR11: 
MOV 
MOV 
SETB 
MOVX 
JNB 
JB 
SETB 

SUNR12: 
MOV 
ADD 
MOV 
MOV 
CUNE 
SJMP 

SUNR13: 

MOV 
MOVX 

INC 
MOV 
MOVX: 

DEC 

SUNR14: 
MOV 
MOV 
MOV - 

_MOVX 


vrtScrlFlg,$ 
SwbBit ~ 
SUNRS 


SudBit, SUNR9 
VrtScrlFlg,$ 


SudBit 


HidCsr 

VrtSeriCnt 

CurMDBFlg,SUNR10 

RO, #BgdMDB1.AN-OFST+MDB_Scrl 
SUNR11 


RO,#BgdMDBO.AN.OFST+MDB_Scrl 
P2, #BgdMDBO.SR.PAGE 


A,ScrlByt 
ACC.0 


@r0,A 


vrtScrlFlg,$ 


VrtScrlNewFlg,$ 
VrtScrlNewFlg 


A, Rcbof f 
A, #RCB_RowPag 


“RO,A 


A, EndRow 
A, BtmRow, SUNR13 
SUNR14 


P2,A 
aRO,A 


—RO- 


A, RcbOff 
@RO,A 
RO 


A, BgnRow 
ExtRow,A 
P2,A 

A, aR 


;same area scroll in progress 


swait for scroll in prog 
sclear to indicate bgrd scroll 


sskip if same type of scroll 


swait for scroll in progress < 
sinitiate scroll - ae 
smark scroll up in progress 


scursor hidden while scrolling Out: 
sone more row to scroll 
sskip to correct main def 


RO = main def of fset 


(7RO main def offset 


:P2 = main def page 
sset scroll byte in main def 


;wait for scroll to start _ 
swait for beginning row free 
smark beginning row not free 


;RO = offset of nex row page 


;old beginning row becomes 
. the extra row 
;P2 = new extra row 
7 following row becomes new 


MOV 
RET 


In: : 


BgnRow,A 


A 

VrtSerlFlg 

SwbBit 

SudBit 

VrtSerlCnt 

main and window def blocks 
DPTR,P2,A,RO,R4,R7 


MsgActFlg,SDD1 


R7,A 
AMDSCMBit,SDD4 


VrtScrlFlg,$ 
HidCsr 


SetForScrlDn 
SetAftScrlDn 
R7,SDD2 
PlcCsr 


-A,R4 


WndActFlg,SDD3 


DPTR, #WndWDBO+WDB_RowPag 
@DPTR,A 


DPH 
QDPTR,A 


DPTR, #BgdMDBO+MDB_RowPag 
@DPTR,A 


DPL,#BgdMDB1.AN.OFST+MDB RowPag © 


@DPTR,A 


beginning row - 


SERRE EEE EEE EEE EE EEE EEE EEE EE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE 
ScrltDnDsp: 


Scrolls the display downward the given number of rows: 


number of rows to scroll 

vertical scroll flag 

window/bgrd scroll flag 

up/down scroll flag ; 

smooth scroll row count | 

top row page and smooth ‘scroll ctrl 


smessage area does not scroll 


ssave scroll count 

;skip if smooth scroll 

scroll 

swait for scroll in progress 
:cursor hidden while scrolling 
SetForScrDn R7 times . 


sput the cursor back 

3A = top visible row 

sskip if not in window 
scrolling in window 
set DPTR to point to one WDB 
;Pow page is top visible 


snow other WDB 4 


;jump scrolling in background 

sset DPTR to main‘def first row 
set this to top visible 
‘syrepeat for second main def 
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WndActF lg, SDD5 


SwbBit,SDD6 
VrtScrlFlg,$ 
SwbBit 

SDD7 


‘gsmooth scrolling 


sskip if not in window 

ssmooth scrolling in window 
sskip if scrolling in window now 
;wait for scroll in progress _ 
sset flag fro scroll in wnd 
sinitiate scroll 


- ;smooth scrolling in background 


SwbBit, SDD6 
VrtSerlFlg,$ _ 
SwbBit 

SDD7 


SudBit,SDD8 
vrtScrlFlg,$ 


sskip if scrolling in bgrd now 
swait for scroll in progress 
sset flag for scroll in bgrd 
sinitiate scroll 

sscroll in progress 
sskip if scrolling down in prog 
wait for scroll in progress 


sinitiate scroll 


SudBit 


HidCsr 

A,R7 

A,VrtSerlCnt 

VrtScrlCnt,A 

VrtSerlFlg,SDD13 

SetForScrlDn 

WndActFlg,SDD10 
R1,#TOWSftLoInd 

R3, #WndWDBO.AN.OFST+WDB_RowPag 
CurWDBF lg, SDD9 


_ CurWDBFig 


R2, #WndWDB1 .SR «PAGE 
SDD 12 


CurWDBFlg © - 
R2, #WndWDBO.SR.PAGE 
spD12 


R1,#TOPSftLoInd 
R2,#BgdMDBO.SR.PAGE 
CurMDBFlg,SDD11 


. CurMDBFlg 


R3,#BgdMDB1.AN.OFST+MDB_RowPag 
SDD 12" 


sindicate scrolling down 

sadd to scroll count 
scursor hidden while scrolling 
srestore requested scroll count 
sget new total vert scrl count 


iskip if scroll in progress 
"prepare new top row 
‘ gjump if not in window 
ssetup for write to Am8052 reg 
soffset into WDB top row ptr 
sselect alternate WDB page 


ssetup for write to Am8052 
;backgrd MDB page in P2 
sselect alternate MDB top row off 


s;MDB1 if flag was set 


SDD11: 
CLR 
MOV 

SDD12: 
MOV 
MOV 
MOV 
MOVX 
DEC 
DEC 
LCALL 
MOV 
MOV 
SETB 
MOV 
MOV 
CLR 
MOVX 
MOVX 
SETB 
JNB 

SDD13: 
RET 


CurMDBFlg 
R3,#BgdMDBO.AN.OFST+MDB RowPag 


A,R4& 

DPH,R2 

DPL,R3 

@DPTR,A 

R3 

R3 

WrAm8052Reg 

P2, #BgdMDBO.SR.PAGE 
A,ScrlByt 

ACC.0 

RO, #BgdMDBO.AN.OFST+MDB_Scrl 
R1,#Bgd0MDB1.AN.OFST+MDB_Scrl 
Ex0 

@RO,A 


-@R1,A 


EXO 
VrtScrlFlg,$ 


sMDB2 if flag was clear 


zynew top visible row 


sMDB page in P2 
supdate scroll byte in both 
+ MDB's 


sno 8052 access while doing this 


SEEEEEEEEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EE EEE EES EEE EE EE TEE EEE EEE E EEE t ttt ttt 
SetForScrlDn: , 


=e 


=e =e Ln) =s8 =e %e &s8 Fe BS CH VHA B® 


(none) 

R4 

VisRow 

row control blocks 
TopRow — 

BtmRow 

RemRow 


A,RcbOff 


‘A, #RCB_RowPag 


Sets the vertical scroll row-variables for a scroll down. This routine may 
be. called from an interrupt handler. 


top visible row 

decremented 

threading changed 

moved up via thread 

moved up via thread 

changed to old _reamining row 


smove the top visible up 
sDPL = offset of the field in the 
: row control block which 
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a 
_ « 
f 
. 
f 


MOV. 
MOV 


SFSD1: 


MOV 


_ MOVX 


CJNE 


MOV 
‘MOV 


RET 


DPL,A = points to offset of next RCB 
A, BgnRow ‘A = beginning row page 


;DPH = row page 

;fetch the next row page 

cont until the top row is next 
make row before top 

the new top row 


DPH,A 

A, @DPTR 

A, TopRow, SFSD1 
R4,DPH ~~ 
TopRow,R4 : : 


SEEEEEEE EEE EELT EE EEE EE EEE EEE AEE TEE TEE E TEESE EEE T ETE EEE E TEE E TEE E FETT E ET TEE EEE 


SetAftScrlDn: — 


e é > : 
euneeenenenevunnennnreoeseenaneseseeeenenesaenseesesensesese Seveeeseeeceeseeneseeveeesvnaesnvneene 


Sets the vertical scroll variables after a scroll down. This routine may 
be called from an interrupt routine. : 


A,Rcboff 

A, #RCB_RowPag 
DPL,A- 

A, TopRow es 


DPH,A 
A, @DPTR 


A, BtmRow, SASD1 


BtmRow, DPH 
A, TrmRow 
EXO , 
QDPTR,A 
DPL 

A, TrmOff 
@DPTR,A 
EXO . 

A, TrmOf f 
A, TrmRow 
DPH,A 

A, Rcboff 
QDPTR,A 
DPL 
A,RemRow 
@DPTR,A 
RemRow, DPH- 


a= 


ZEEE EEELFEE ELE E EEE ADEE EEE EEE EEE EEE EEE EE EE EEE EE EEE EEE EE TEE TET ETE EE EEE ttt ttt 


ScriLtDsp: 


A 

HrzScrlFlg 

HrzDirFlg 

HrzDspFlg 

HrzPxlShf 

HrzFrmCnt ° 

HrzFrmSet 

HrzSerlCnt 

(see also ScriLtOne) 
A,RO,R1,R2,R3,R4,R5,R7 


WndActFlg,SLD1 


R7,A 
AMDSCMBit, SLD3 
HrzScrlFlg,$ 
HidCsr 
MsgActFlg,SLD2 
WndVisFlg,SLD2 
Hidwnd 
DlyTilEndFrm 


ScrlLtOne 
R7,SLD2 
MsgActFlg,SLD2a 
SetWndPos ~ 
WndVisFlg,SLD2a 
ShwWnd 


PicCsr 


MsgActFlg,SLD4- 


HrzDspFlg,SLD5 


, 


number of columns to scroll 


scan't scroll horz in window 


2 


ssave scroll count in R7 
zskip if smooth scroll 

swait for scroll in progress 
shide cursor while scrolling 


ScrlLtOne R7 times 


sreplace the cursor 


ssmooth scroll 

:skip if not message area 
smessage area is active 

sskip if scrolling message area 


42 
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HrzScrlFlg,$ 
HrzDspFlg 
SLD6 


HrzDspFlg,SLD5 
HrzScrlFlg,$ 
HrzDspF lg 


SLD6 


HrzDirFlg,SLD7 
HrzScrlFlg,$. 


HrzDirFlg 


HidCsr 
MsgActFlg,SLD7a 
WndVisFlg,SLD7a 
HidWnd 


A,ScrlByt 
A, #SCRL_RAT_MASK 
A 


A 


ACC.3,SLD10 


HrzFrmSet, #1 
A 
AMDDWMBit , SLD9 


Cc. 
A, #7 
SLD8 


A,#7 


HrzPxtShf,A 
SLD11 


A 
HrzFrmSet,A — 
HrzPxlShf ,#1 


swait for scroll in progress 
smark scrolling in message 
sset scroll rates 


sbackground is active 


sskip if scrolling in bgrd 
zwait for scroll in progress 


- gmark. now scrollin in bgrd 


sset scroll rates © 


skip if now scrolling left 
wait for scroll in progress 


s 
s 
e 
a 


smark scrolling left now 


2A = old scroll byte 

sextract scroll rate bits 
z;move rate to upper nibble 
;move rate to lower nibble 
z:skip if pixel every n frames 


sscrolling n-pixels per frame 


smark num. frames to next move 
sconvert to number per frame 
sskip if-normal width 


compressed display 


scheck for 7 or 8 per frame 


skip if 6 or fewer 
slimit to 6 for frame 


sconvert back to pixels per frame 


‘set this in the variable 


sinitiate the scroll 


sscrolling 1 pixel every n frames 


s;A = number of frames 
smark num frames to next move 
smark single pixel shift 


JB 


MOV 

- SETB 
SLD12: 
MOV 


ADD - 


- MOV 
SETB 


RET 


ETO 
HrzScrlFlg,SLD12 


HrzFrmCnt, #1 
HrzScrlFlg 


A,R7 
A,HrzSerlCnt 


’ HrzScerlCnt,A 


ETO 


. ensure no interruptions 
" gskip if scroll in progress 
snow starting a scroll 


sinitiate on next frame 
smark scroll in progress 


“sadd new request to old count 


sallow horz smooth scroll intr 


SEEEEEEEEEEEEE EEE EEE EEE E EEE EE EEE EEE EEE EE EEE EEE EE EEE EEE FEET ETE T TET t EET Tt tt ttt ttt 
ScrlLtOne: 


In: 
Out: 


=e ®™e Be Se Sse SS Bs BH BH Bs 


position. 


“Cnone) 


VisCol 
row control. blocks 


Scrolls the active display (background or message) left one character 
This routine may be called from an interrupt handler. 


incremented 


attribute of old leftmost visibles 
DPTR,A,RO,R1,R2,R3,R4,R5 


MsgActFlg,SLO1 


DPTR,#MSgRCB+RCB_2nd+SEG_NumHid 


A, @DPTR 
R1,A 

A 

A,R1 

A 

EXO 
QDPTR,A 
DPL 

A, QDPTR 
A 
QDPTR,A 


DPH, #MsgAtrBuf.SR.PAGE — 


DPL,R1 
A, @DPTR 


:skip if scrolling bgrd 


sscroll the message 


2A = 2nd seg, number hidden 
: in message area 


~-tsave old number hidden in R1_ 


sdouble old number hidden 

sold number back in A 

sone more hidden column 

-;no 8052 access while changing 
: to new hidden col count 
snow decrement number visible 
: in this segment 


snow set the ignore bit 
: in the attribute of the 
: previously leftmost visible 
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ACC.5 
@DPTR,A 
EXO 
VisCol 


DPH, CurRow 


- character 


snow allow 8052 access 

supdate horz scroll position 
scroll the background 

suse current row 


DPL, #BgdRCBO.AN.OFST+RCB_2nd+SEG_NumVis 


A, @DPTR 


‘SL02 
DPL, #BgdRCBO.AN.OFST+RCB_3rd+SEG_NumVis 
‘A, @DPTR . 


A 
R5,A 
DPL 


_RO,DPL’ 


A, @DPTR 
R4,A 


Rh 


A,VisCol 


A 


R1,A. 


R2, #BgdRCBO.SR.PAGE 
.R3, #BgdAtrBuf0.SR.PAGE 


DPH,R2 


DPL,RO 


A,R4 
EXO 


-@DPTR, A. 


DPL 
‘A,R5 


@DPTR,A 


DPH,R3 
DPL;,R1 
A, @DPTR 


-ACC.5 


aDPTR,A 
EXO 
R3 


R2- 
R2, #BgdRCB30.SR.PAGE+1, SLO3 


;get number visible in 2nd seg 
skip if not zero 


get number visible in. 3rd seg 


;reduce number: visible 

zkeep number visible in R5 

7point back to number hidden 

7save this ptr in RO 

3A = old number hidden 

:R4& = old number hidden 

7R& = new number hidden 

ghorz scroll position ; 

7A = double above for attr offset 

;save old attrib offset in R1 

;R2 is ptr to first RCB 

;R3 is ptr to first attribute 
s;row loop point 

;DPTR points to number hidden 

: in this row. 

z;A = new number hidden 

-sno 8052 access while changing 

zyset new number hidden 

‘spoint to number visible 

;set new number visible 


:DPTR points to attribute of 
; ~ old leftmost visible 
schange to ignore this character 


30K for 8052 access now 
_ pnext row control block 
“next block of attributes 
~ scontinue until al 31 are done — 


4S 


INC 
RET 


VisCol - 


SALEEEELEEEE LEAL EE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE ES EEE EEE EEE EEE EET ETT ttt tt 


ScrlRtDsp: 


° 
v 


In: 


“es Se Se =e ma =A =s =a =a =e =e =e 6% =a 


LCALL 


“JB 
- JNB 


LCALL 
LCALL 


_. SRD2:.. 


LCALL 
DJNZ 


JB. 


Out: 


columns. 


A 

HrzScrlFlg 

HrzDirFlg 

lirzDspF lg 

HrzPxlShf 

HrzFrmCnt 

HrzFrmSet 

HrzSerlCnt 

(see also. ScrlRtOne) 
A,RO,R1,R2,R3,R4,R5,R7 


WndActFlg,SRD1 - 


R7,A 


~ AMDSCMBit, SRD3 


HrzSerlFlg,$ 
HidCsr 


MsgActFlg, SRD2 
WndVisFlg,SRD2 


Hidwnd 
DlyTiLEndFrm 


ScrlRtOne 
R7, SRD2- 


“MsgActFlg,SRD2a 


LCALL ‘SetWndPos 


JNB 


LCALL 


SRD2a: 


LCALL 


RET 


WndVisFlg,SRD2a 
ShwwWnd 


, 


PicCsr . 


Scrolls the active display. (background or message) right the given. number of 


number of columns to scroll . 


scan't scroll horz in window 


;save scroll count in R7 ~ 
z:skip if smooth scrotl 
zwait for scroll .in progress 


ScrlRtOne.R7 times 


_ ¢replace the currsor 
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~ SRD3: 


JNB  MsgActFlg,SRD4 


“JB - HrzDspFlg,SRD5 
JB. HrzSertFlg,$ 
SETB HrzDspFlg .. 
SJMP — SRD6 
SRD42 
JNB-  HrzDspFlg,SRD5_ 
JB HrzScrlFlg,$ 
CLR  HrzDspFlg 
SUMP SRD6 
SRD5: 
HrzDirFlg,SRD/ 
-JB ss HrzSerlFlg,$ . 
SRD6: . 
SETB UHrzDirFlg 
SRD7:. 
~ LCALL HidCsr 
JB MsgActFlg,SRD7/a 
JNB  WndVisFlg,SRD/a 
LCALL. HidWnd 
SRD7a: : 
MOV A,ScrlByt 
ANL A, #SCRL_RAT_MASK 
RL OA 
SWAP A 
JBC ACC.3,SRD10 


‘MOV -HrzFrmSet, #1 
INC A 
JNB  AMDDWMBit, SRD9 


CLR Cc 

SUBB  A,#7 

JC SRD8 — 

MOV A,#-1_ 
SRD8: 

ADD A,#7 
SRD9: | 

MOV HrzPxlShf,A 

SJMP SRD11 


:skip if background active 
sscrolling in message 
;skip if scrolling in msg 
wait for scroll in progress 
_ mark scrolling in msg 
sset scroll rates 
rscrotling in background 
iskip. if scrolling in background 
wait for scroll in progress - 
smark scrolling in bgrd 
zsset scroll rates . 
snow scrolling . 
'  yskip if now scrolling right 
zwait for scrott in progress 
zyinitiate scrolling. 
smark scrolling right 


;fetch scroll byte 
;get rate in lower nibble 


7skip if.1 pixel. per n frames 
7scrolling n pixels per frame 
31 frame per scroll 
= number of pixels per frame 
sskip if normal 
; compressed 
' scheck for rate sf 7 or 8 


slimit rate to 6 


sconvert back to rate 


sset pixels per frame 
zsinitiate scroll 


sscrolling 1 pixel per n frames 
A , zA = frames per pixel 
HrzFrmSet,A ad . ;set number of frames per scrl 
HrzPxlShf ,#1 salways one pixel shifted 
sstart scrolling . 
ETO aw sensure no interruptions 
JB‘ HrzScerlFlg,SRD12 | sskip if scroll. in progress. 
snow starting a scroll * 
MOV -HrzFrmCnt,#1— ;initiate on next frame - 
SETB HrzScrlFlg smark scroll in progress 
SRD12: | . : - 
MOV A,R7 - sadd new request to old count 
ADD A,HrzSerlcnt 
MOV HrzSerlCnt,A me 
SETB ETO che sallow horz smooth scroll intr 
RET , 


SEEEEEEEEEEEEEEEL EEE FEET EEE EEE EE EEE EET EE EEE ET EEE EEE E EE ETE T FTF TE FT TTT tT ttt 
Scr LRtOne: | 
EE ee LE ee ee ee rE eT er ee Cee ee eT ne sivee sacs 
Scrolls the active display (background or message) right one character 
-position.: This routine may be called from an interrupt handler. 
a 
(none) 
VisCol decremented 
row control blécks 
attribute of old rightmost ignored 
DPTR,A,RO,R1,R2,R3,R4,R5 


‘svisible column decremented 

MsgActFlg,SRO1 sskip if not in msg . 
sscrolling message 

DPTR,#MsgRCB+RCB_2nd+SEG_NumHid zptr to number hidden,. 2nd seg 
A,@DPTR :A = old number hidden 

sreduce number hidden 

2R1 = old number hidden 

‘;double for attr offset 

ssave attribute offset in R1 

sno 8052 access while changing 


zincrement number visible 





98-d 


- DPH, #MsgAtrBuf .SR.PAGE 


A 
@DPTR,A 
jnow. point to attribute 
DPL,R1 : of old rightmost hidden 
A, a@DPTR 
Acc.5 smake it visible 
ADPTR; A | 
EXx0 sOK for 8052 access now 


zscrolling in background 
DPH, CurRow ;use current row (any would do) 
DPL,#BgdRCBO.AN.OFST+RCB_3rd+SEG NumHid 
A, aDPTR. ;check for hidden in 3rd seg 
SRO2 | Skip if some hidden there 
DPL,#BgdRCBO.AN.OFST+RCB_2nd+SEG_NumHid . 
A,aDPTR | zelse use 2nd segment 


RO,DPL ;save the pointer to hidden 
A sdecrement the number hidden 
R4,A save number in R4& 

A,VisCol shorz scroll position 

A 7R1 = offset of attribute 
R1,A _ 2 Ge for new first visible 


. DPL ;point to number visible 


A, @DPTR ; 

A *-  =R5 = new number. visible 

R5,A a 

R2, #BgdRCBO.SR.PAGE :R2 = first RCB 

R3, #BgdAtrBuf0.SR.PAGE ;R3 = first attribute vlock 
7 zscroll row loop 

DPH,R2 ;DPTR->number hidden in RCB 

DPL,RO . 

A,R4 | :A = new number hidden 


EXO oe ;no 8052 access while changing 


@DPTR,A ; . supdate: number hidden 
DPL . point to number visible 
A,R5 yset that from R5 


 @DPTR,A 


DPH,R3 , ; spoint to attribute of new ist 
DPL,R1 ; visible. 

A, aDPTR. ;mark it visible 

ACC.5 | . 

@DPTR,A 


SETB - 
INC R3 

INC R2 

CJNE R2,#BgdRCB30.SR.PAGE+1, SROS 
RET 


70K for 8052 access now 
snext attribute block 

snext RCB 

;continue through 31st row - 


SHEEEEEET EEE EE EEE EEE TEESE EEE EEE EEE EEE EEE EEE TET E TET EEE TFET TEE EEE EEE TET ttt ttt 


SetWndPos:. 


; Set new window position — 


Determines the current window position and sets the background's row control 


block segments accordingly. 


VisCol. 

BgdRCBO-BgdRCB30 

_WndCol 

Coloff 
A,DPTR,RO,R1,R2,R3,R4,R5,R6,R7, 
DPTR, #8gdVarBuf+(VisCol -CurAtr) 
A, @DPTR . . 
MsgActFlg,SWPO 

WndActFlg,SWPO 

A,VisCol 


RO,A. 
_AMDDWMBit, SWP1 
A, #68 
SWP2 


A, #28 


A,RO 
ACC.0 
WndCol ,A 
A,RO 
‘RI1,A 

JA . : 

-DPTR, #WndWDBO+WDB_BgnCol 

@DPTR,A 

DPTR, #WndWDB1+WDB_BgnCol. 

@DPTR,A 

WndActFlg, SWP3 

ColAdd,A 


background horizontal scroll position 
segments updated . nit 
window position relative to background 
updated when window is active 

PSW re 


_Jump if normal mode 
Compressed. window position 
"and continue 


Normal window position 


. Compute actual total offset. 
aligned on word boundary . 
and keep it We ae 

Compute actual visible offset 
and keep it a 
‘Add one for invisible function — 


=e Ss Se Sa Bs ME 


* 


Jump if window. not active 
else save offset | 
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~ SWP3: 


MOV 
"ADD 
DEC 
MOV 
MOVX 
MOV 
MOVX 
MOV 
“ADD. 
MOV 
ADD 
“MOV 
MOV 
ADD 
ADD 
MOV 
ADD 
ADD 
MOV 
CLR 
MOV 
SUBB 
SUBB 
MOV 
MOV 
SWP4: 
CLR 
MOV 
MOV 


MOVX . 
~ OPL 


INC 
MOV 
~” MOVX 


‘MOV 
CLR 
‘MOVX 
INC 
MOV. 
MOVX— 


A, WndCol 


“@DPTR,A 


R2, #40 Set visible width of window 
A,R2 

A 

DPTR, #WndWDBO+WDB_EndCol 


@OPTR,A . 


- DPTR, #WndWDB1+WDB_EndCol 


QDPTR,A 

A, #BgdChrBuf0.AN.OFST 
A,WndCol 

R4,A 

A,R2 

R6,A 

A, #BgdAtrBuf0.AN.OFST 
A,WndCol 


Start of bgd chr buffer — 
plus total offset is 
3rd seg chr ptr offset;: 
plus 3rd seg width is 
4th seg chr ptr offset 

Start of bgd atr buffer 
plus twice 
total offset is 
2nd seg atr ptr offset; 
plus twice ' 
3rd seg width is 
4th seg atr ptr offset 

Clear for below 

Width of background buffer 
minus total offset to window 
minus width of window is 
width of 4th segment 

Start at first RCB in memory 

: For each background row control block 

3 No interference from Am8052 


A,R2 
A,R2 
R7,A 
c . 
A, #128 

A, WndCol 

A,R2 

R3,A 

DPH, #BgdRCBO.SR.PAGE 


s 
s 
. 
' 
° 
‘ 
° 
’ 
s 
’ 
. 
’ 
oe 
s 
. 
’ 
R5,A : 
a ’ 
. 
’ 
. 
’ 
os 
’ 
se 
’ 
s 
’ 
Lt 
‘ 
. 
€ 
om 
‘ 
e 
‘ 


EXO 


_ DPL,#BgdRCBO.AN.OFST+RCB_2nd+SEG_ NumHid 


Horizontal scroll offset into 
2nd seg hidden count 


A,RO %e ' 
@DPTR,A : 


Offset to window boundary into 
2nd seg visible count 


A,R1 


- The second segment's character and attribute pointers never change. 


DPL, #BgdRCBO.AN.OFST+RCB_3rd+SEG_NumHid 
A : Zero into 

@OPTR,A : 3rd seg hidden count 
DPL 
A,R2 
QDPTR,A 


Width of window into 
3rd seg visible count 


MOV 
MOV 
- MOVX 
MOV 
MOV 
MOVX 
MOV 
MOV 
MOVX 


DPL, #BgdRCBO.AN.OFST+RCB_3rd+SEG_ChrOff 
A,R4 ; 
@DPTR,A : 
DPL, #BgdRCBO.AN.OFST+RCB_3rd+SEG_AtrOff 
A,R5 : Corresponding offset into 
@DPTR,A : - 3rd seg attribute pointer 
DPL, #BgdRCBO.AN.OFST+RCB_4th+SEG_NumVis 
A,R3 
QDPTR,A : 


Even boundary offset into 
3rd seg character pointer 


Remaining character count into 
4th seg visible count 


: The fourth segment's hidden count is zero and never changed. 


MOV 
MOV 
MOVX 
MOV 
MOV 
MOVX 
SETB 
“INC 
MOV 
CUNE 


RET 


DPL, #BgdRCBO.AN.OFST+RCB_4th+SEG_Chroff 

A,R6 ; Next boundary offset into 
QDPTR,A . : 4th seg character pointer 
DPL, #BgdRCBO.AN.OFST#RCB_4th+SEG_AtrOff 

A,R7 

QDPTR,A 

EX0 

DPH 

A,DPH 

A, #8gdRCB30.SR.PAGE+1-, SWP4 


Corresponding offset into 
4th seg attribute pointer - 
Allow Am8052 bus requests 
Next row control block 
Check it and 
jump if not finished 


, 
=e *e se %8 Se BE 


Exit 


SEEELELEEEELE EEE EEE EE EEE EEE E TEETH EEE EET E ETE E FEET TTT E ET EET I TT ETT TFET 


Ins 


me =e as =e =a ee =e me 


_ RdAm8052Reg: 


Am8052 register number 
high byte of value read 
low byte of value read 


sensure no Am8052 interruptions 
sgive Am8052 address strobe 


spoint to Am8052 control reg 
zindicate register to be read 


Am8052XfrFlg 
DPTR, #AmB052Ptr 
A,R1 

@DPTR,A = 
DPTR, #AMB8052RegLo zspoint to low data byte 


52 
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MOVX 


MOV | 


DEC 
MOVX 
_ MOV 
SETB 
" SETB 
SETB 
RET 


- A, ADPTR 


R3,A 

DPL 

A, aDPTR 
R2,A 
AmB8052XfrF lg 
EXO 

EX1 


‘;read low data byte 


spoint to high data byte 
sread high data byte 


sremove Am8052 address strobe 
gallow Am8052 interrupts 


SEEEEEEE EEE EE EEE EEE E EE EEE EEE EEE EEE EE EE EE EEE EE EEE EEE TEE E EPEAT ETE TEST HEF 
WrAm8052Reg: © 


Writes the given value to the specified register in the am8052. 


MOV 
MOV 
MOVX 
INC 
MOV 

. MOVX 


SETB 


SETB 
SETB 
RET 


AmB052XfrFlg 


DPTR, #AMB052Ptr 


—A,RI 


QDPTR,A 
DPTR, #Am8052RegHi 
A,R2 
@DPTR,A 


_DPL 


A,R3 
@DPTR,A 
Am8052XfrFig 


EXO 


EXx1 


Am8052 register number 
high byte of value to. be written 
low byte of value to be written 


sensure no Am8052 interruptions 


zgive address strobe to 8052 — 
sset pointer to 8052 control 
;select register 


sset ptr to 8052 data 
sset high byte 


sset ptr to low data 
sset low byte 


sremove 8052 address strobe 
sallow Am8052 interrupts 


SEAL EL EEE EEE EEE E EEE E EEE EEE EEE TEE EEE EET E TT EEE ET HEE ATTA TTI TTI ETT 


SetRowFntRdfPtr: 


Sets the first-15 visible row redefinition block pointers to the 
font loading redifinition blocks 


inputs none 
outputs none 


=e Ss ese Be Se BA Ge 


MOV P2,TOpRow 

MOV R2,#EntRRBO.AN.OFST 

MOV R3,#FntRRBO.SR.PAGE ; 
MOV RO, #BgdRCBO.AN.OFST+RCB_BgdRdfPag . 
MOV _R1,#BgdRCBO.AN.OFST+RCB_RowPag 

MOV R4,#15 

SRFRP1: 

MOV A,R3 

MOVX RO,A 

INC RO 

INC RS 

MOV A,R2 

MOVX a@RO,A 

DEC RO | 
_MOVX A,aR1 

MOV P2,A 

DJNZ R4,SRFRP1 

RET 


SEEEEEEEEE EEE EE TE EEE EEE EEE EET ETE EEE REET FETE T TET ET EEE ETE IATA TSAI FETE, 


SetRowNmlRdfPtr: 


e 
e 
e 
e 
° 
a 
e 
¢ 
° 
a 
° 
e 


Sets the first 15 visible row redefinition block pointers to the 
normal redifinition blocks 


inputs none 
outputs ‘none 


eoveeen seeesecceneosaeannesasessesneseeaesessenenee 


=e 


RO, #8gdRCBO.AN.OFST+RCB_BgdRdfPag__ 
R1, #BgdRCBO.AN.OFST+RCB_RowPag 
R2,#15 | 





Change page pointer in RCB 


Change offset of pointer in RCB/| 


eevoeaeovennueveoen seavnenaestenaeenanue weenonneneses eeeeveveneneneeaenassa eeeeceannesn 


“Number of rows to update 
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a 
° 
s 
° 
e 
° 
a 
. 
‘ 


SRNRP1: 


MOV A, #NrmRRB.SR.PAGE 
MOVX .@RO,A 
INC RO | 
MOV A, #NrmRRB.AN.OFST 
MOVX ARO,A 
“pec RO. 
MOVX A,@R1 
MOV P2,A 
DJNZ R2,SRNRP1 
RET | 


} 


Change page pointer in RCB 


Change offset of pointer in RCB 


; EEEEEEEEEEEEEEE EEE EEEEEEEEEE EEE EE EEE EEE EEE ESE EEE EEF EEE EEE EEE EEF Ett ttt ttt ttt 


WrFfntCel: 


=e =e =e 


parameter buffer. 


In: A 
PrmCnt 
PrmBuf 


MOV RGA. 
MOV R6,CsrSiz 
‘MOV CsrSiz,#0FFH 
LCALL ChgCsrSiz 
MOV CsrSiz,R6 . 
MOV _P2,#FntRRBO.SR.PAGE 
MOV -R6, #15 
MOV _R1,#PrmBuf 
MOV R2,PrmCnt 
MOV A,@R1 
INC RI 
DEC. R2 
MOV _R3,A 
MOV A,a@R1 
INC RI 
DEC R2 
- . JZ * ~WEC2 
MOV R5,A 
WFCI: 


Writes to a single character generator cell the pattern specified in the 


font select (=0 normal, <>0 compressed) 
parameter count 
list of parameters 


Ye 
eenessecevtienenveenseatasesensenenesenseseneeeseneneeseaeteseanansanseesasanesaeeeeeasn 


~ 


MOV RO, #FNtRRBO.AN.OFST+RRB_ApHi_Spcshi 


55. 


A 

@RO,A 
RO, #FntRRBO.AN.OFST+RRB_ApLo SbcsHi 
A 

ar0,A 

P2 

R6 ; 

R5,WFC1 


A,R2 
WFC4 


A,aR1 

R1 

R7,A 

A, #0F8H 

A | 

RO, #FntRRBO.AN.OFST+RRB_ApHi_SpcsHi 
@R0,A 
A,R7 

A,#07H 

A. 

RO, #FntRRBO.AN.OFST+RRB_ApLo_SbcsHi 
@RO,A 

P2 

R6 

R2,WFC3 


A 

RO, #FntRRBO.AN.OFST#RRB_ApHi_SpcsHi 

@RO,A 

A 

RO, #FntRRBO.AN.OFST+RRB_ApLo_SbcsHi 

@RO,A 

P2 

R6,WFC4 

DPTR, #8gdFncChrO Set character cell value in 
A,R3 dummy character 
@DPTR, A 

A,R4S 

WFC5 

R6 , #044H 

R7,#010H 

WFC6 
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R6, #042H 
R7, #090H - 


DPTR,#BgdFncAtrO 
A,aDPTR 
R5,A 
DlyTilEndFrm . 3 Wait until ready 
SetRowFntRdfPtr . Reset RDFptrs to font RDF's 
DPTR, #BgdFncAtr0 
A,R6 
| EXO 
MOVX @DPTR,A 
INC DPL 
MOV A,R7 
MOVX aDPTR,A 
SETB EXO 
LCALL DlyTilEndFrm — it's thing, when known to 
CUNE R5,#004H,WFC7 
MOV = A,#010H 
SJMP WFC8 
WFC7: 
MOV A, #0901 
WFC8: 
CLR EXO 
MOVX @O0PTR,A 
-DEC ODPL 
MOV - A,R5 
MOVX @DPTR,A 
SETB EXO : —— 
LCALL SetRowNmlRdfPtr Clean up after ourselves 
LCALL ChgCsrSiz’ . 
RET 


“ f : - 
SEER EEE EE EEE E EEE EEE EEE E EEE E EEE E FEET EEE EEE TEE E TEE TEPE EEE EE ETAT TATE PE 


; end of GUtil - 
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"go51" 
TITLE ™ CALEB 0.00 Initial Font" 
SEETEELELEEEEEE EEE EDEL EEEE EEE EEE EE ETE EEE E EEE T EEE TEE E EEE E TEEPE TEEPE TEEPE TT ttt 


> C_Font CALEB 0.00 


Copyright 1985° Advanced Micro Devices, Inc. 


This is the compact, binary representation for the default font to be loaded 
during initialization. 


NAME “Initiak& Font" 
PROG ee 
LEEEEELEEEEEE EEL TEESE EEE TEE EE EEE EE EE EE EEE E EEE TE EE EEE EEE EF EF ET FETT TET ET TEEPE FT Tt 
GLB = Fnt_5x7 > ‘: Initial compressed. mode font 
GLB. = Fnt_7x9 :- Initial normal mode font 


SHEETEEEEL ETHEL EEE EE ESTE EEE EEE EEE PEE EEE EE EEE ET EEE EEE EEE EEE ETE EEE E EPTFE TFET EET Tt 


SKIP 
SEEEEEEEELELEEEE EEE EEE LESTE EEE EEE EEE E ETE EEE T EEE E TEE TET Et FTE t EFT T TTP T FETT Tt ttt 


Fnt_5x7/: ; Initial compressed mode font 
DB - 041H,000H,007H,070H, 088H, 088H , 088H, OF8H , O88H , O88H 

DB 042H, OOOH, 007H, OFOH, 088H, O88H , OFOH, O88H , O88H , OFOH 

DB 000H,000H,O00H' - 


~ 


SEELEEEEELE EL ELE EEE EEE EEL EEE E TEE EEE E ELE E EEE E TEETH EEE PTET ET ETT TET E EEF F TFET TT ttt 


SKIP 
SEEELELEE EEE EEE LEE EE EE ELEE EEE EEE E LETTE EEE ETE EEE E EET A EE ETE TET PTT EPTFE TTT T TTF ttt 


Fnt_7x9: -; Initial normal mode font 
‘DB —s-021H, OOOH, OO9H , O10H, 010H, 010H, 010H ,010H, OOOH, OOOH, 010H,010H 
DB 022H ,000H ,003H, 048H, 048H, 048H 

DB 023H,000H,009H,038H,044H,040H,040H, OEOH,040H,040H,042H,OFCH 
DB 024H ,O00H,009H,010H, O7EH, O90H, 090H, O7CH,012H,012H,OFCH,010H 
DB  025H,000H,009H,040H, 0A2H,044H,008H,010H,020H,044H, 08AH, 004H 
‘DB- ‘026H,000H,009H,070H, 088H, 088H ,050H,020H,052H,08CH, 08CH,072H 


=e sa =e =a =s =e 


027H, OOOH ,004H ,018H ,018H,010H ,020H : 
028H, 000H , 009H , 008H , 010H , O20H ,020H, 020H, 020H ,020H, 010H, 008H 
029H, 000H , 09H ,020H ,010H, OO8H ,008H, 0O8H, 008H , OO8H, 010H, O20H 
O02AH,001H, 007H,010H, 092H, 054H, 038H, 054H, 092H,010H 

02BH, 001H, 007H, 010H, 010H, 010H, OFEH, 010H, 010H,010H 

O2CH, 004H,004H, 030H, 030H,020H, 040H 

02DH, 004H, 001H, OFEH 

02EH, 006H, 002H, 030H, 030H | 
O2FH,001H,007H, 002H,004H, 08H, 010H, 020H, 40H, O80H 


030H ,000H, OO9H , O7CH ,082H , 086H, O8AH,092H ; OA2ZH, OC2H, 082H, O7CH 
031H, OOOH, OO9H ,010H ,030H,050H,010H,010H,010H,010H,010H,O7CH 
032H, OOOH, OO9H, O7CH, 082H, 082H, 004H, 038H, 040H, O80H, O80H, OFEH 
033H, OOOH, OO9H, O7CH, 082H, 002H, 002H, O3CH , 002H, 002H, O82H, O7CH 
034H, 000H, 009H, 004H, OOCH, 014H,024H, 044H, 084H, OFEH, 004H, 004H 
035H, 000H, OO9H, OFEH, O80H , O80H , OF8H, 004H, 002H, 002H, 084H, O78H 
036H, OOOH, OO9H, O3CH, 040H, O80H, O80H, OFCH, 082H, 082H, 082H, O7CH 
037H, OOOH, OO9H, OFEH ;082H, 004H, 008H, 010H, 020H, O20H, 020H, 020H 
038H ,O00H, OO9H, O7CH, 082H , 082H , 082H , O7CH, 082H , O82H, O82H, O7CH 
039H, 000H, OO9H, O7CH, 082H, 082H, 082H,07EH, 002H, 002H, 004H, 078H 
O3AH ,003H , 006H , 030H ,030H, OOOH, OOOH ,030H, O30H 

03BH ,000H ,008H , 030H ,030H, 000H, OOOH ,030H, 030H,020H, 040H 

O3CH ,OOOH ,OO9H , OO8H ,010H ,020H, 040H ,O80H, 040H,020H, 010H, 008H 
03DH ,003H, 003H,07CH, OOOH, 07CH 

03EH, 000H, 009H, 020H, 010H, 008H,004H, 002H, 004H, O08H, 010H, O20H 
O3FH, OOOH, OO9H, O3CH, 042H, 042H, 042H, 002H, OOCH, 010H, OOOH, 010H 


040H , OOOH, 009H , O3CH, 042H, O9AH, OAAH, OAAH, OBCH, O80H, 040H, 03CH 


_ 041H, 000H, OO9H, 038H, 044H, 082H, 082H, 082H, OFEH, O82H, 082H, 082H 


042H, OOOH, OO9H, OFCH, 042H, 042H, 042H, 07CH, 042H, 042H, 042H, OFCH 
043H , 000H, 009H, O3CH, 042H , 080H , O80H, O80H , O80H , O80H ,042H , O3CH 
044H, OOOH ,OO9H, OF8H, 044H,042H,042H,042H,042H,042H, 044H,OFSH 
045H,000H ,009H, OFEH, O80H, O80H , O80H, OFOH, O80H, O80H, O80H, OFEH 


-046H, 000H,009H, OFEH, O80H, O80H, O80H, OFOH, O80H, 080H ,080H ,080H 


047H, OOOH, OO9H,O3CH, 042H, O80H, O80H, O80H, O9EH , 082H, 042H, O3CH 
048H, OOOH , OO9H, 082H, 082H, 082H, 082K, OFEH, O82H, 082H , 082H,082H 
049H, OOOH, OO9H, O7CH, 010H, 010H, 010H, 010H, 010H,010H, 010H, O7CH 
04AH, OOOH, OO9H, O3EH, O08H, 008H, 0O8H, 008H, OO8H, OO8H , O88H, 070H 
04BH, 000H, O09H, 082H, 084H, O88H, O90H, OAOH, ODOH, O88H, 084H, 082H 
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O4CH , OOOH, OO9H , O80H ,080H , O80H , O80H , O80H , O80H, O80H ,O80H, OFEH 


04DH, OOOH , 009H, 082H , OC6H, OAAH, 092H ,092H, 082H ,082H, 082H ,082H 


-O4EH ,O00H ,009H ,O82H,0C2H , 0AZH,092H , O8AH , O86H , 082H , 082H ,082H 


O4FH, OOOH, OO9H ,038H ,044H,082H,,082H ,082H ,082H ,082H ,044H , 038H 


050H, OOOH, 09H , OFCH, 082H, 082H, 082H, OFCH’, O80H, O80H, O80H, O80H 
051H, OOOH; OO9H; 038H, 044H, 082H,, 082H, 082H, 092H, O8AH, 044H, O3AH 


052H, OOOH, 009H ; OFCH, 082H, 082H, 082H, OFCH, O90H,088H,084H,082H _ 


053, OOOH, OO9H, O7CH, 082H, 080H, O80H, 07CH, 002H, 002H, 82H, O7CH 
054H ,000H, 009H, OFEH,010H,010H,010H,010H,010H,010H,010H,010H 
055H, O00H , OO9H ,082H ,082H, 082H , 082H , 082H,082H, 082H, 082H,07CH 


- 056, O00H , OO9H , 082H,082H, 082H,044H ,044H,028H,028H, 010H,010H 


057H, OOOH, OO9H , 082H, 082H , 082H , 082H , 092H, 092H, OAAH, OC6H , O82H 
058H, OOOH, 009H , 082H, 082H, 044H, 028H ,010H, O28H ,044H, 082H ,082H 
059H, 00H, 009H , 082H ,082H, 044H, 028H, 010H,010H, 010H,010H, 010H 
OSAH, OOOH, 009H, OFEH, 002H, 004H, OO8H ,010H, 020H,040H, O80H, OFEH 
05BH, OOOH, OO9H, 078H, O40H ,040H, 040H, 040H, 040H, 040H,040H, 078H 
O5CH,001H, 007H, 080H,040H,020H,010H, 008H,004H,002H 
05DH,000H, OO9H , 078H, OO8H, CO8H , O08H , OO8H, 008H, OO8H , 08H; 078H 
O5EH, 000H, 003H,010H,028H,044H - 

OSFH,008H, 001H, OFEH 


060H, OOOH , 004H, 030H, 030H,.010H, 008H 

061H, 003H, 006H, 078H, 004H, 07CH, 084H, 084H, O7AH 

062H, OOOH, O09H, O80H, O80H, O80H, OB8H, 0C4H, 084H, 084H, OC4H, OB8H 
063H, 003H, 006H,078H, 084H, O80H, O80H, 084H,078H - 

064H; OOOH, OO9H ,004H,004H, 004H,074H, O8CH, 084H,084H, O8CH, 074H 
065H, 003H, 006H, 078H, 084H, OFCH, O80H, O80H, 078H 

066H , OOOH; 009H, 018H,024H, O20H, O20H, OF8H, 020H, 020H, 020H, 020H 
067H, 003H , OO9H,074H, O8CH, 084H, O8CH, 074H, 004H, 004H , 084H,078H 
068H , OOOH, OO9H, O80H ; O80H, O80H, OB8H, 0C4H, 084H, 084H ;, 084H, 084H 
069H, 001H, 008H,010H, OOOH, O30H,010H, 010H,010H,010H, 038H 
O6AH,003H, 009H, OOCH, 004H, 004H, 004H, 004H, 004H, 004H, 044H, 038H 


_06BH; OOOH, 009H, O80H, O80H, O80H ,088H, 090H, OAOH, ODOH, O88H, 084H 


O6CH, OOOH, 009H, 030H, 010H, 010H;010H,010H,010H, 010H, 010H, 038H 
O6DH , 003H, 006H, CECH, 092H, 092H, O92H, 092H , O92H - 

O6EH ,003H, 006H, OBSH, OC4H, 084H, 084H, 084H, 084H 

O6FH, 003H, 006H , 078H, 084H,.084H, 084H, 084H,078H: 
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DB 
DB 
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‘DB 
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DB 
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DB- 


DB 


BEEEEE HEHEHE HEHEHE HEHEHE EEE EEE EEE HEHEHE EEE EEE EEE HEHEHE EEE HEE+ 


070H, 003H, 009H, OBSH, OC4H, 084H,084H, OC4H, OB8H, O80H , O80H, O8CH 
071H,003H, 009H ,074H, O8CH, 084H, 084H, O8CH, 074H, 004H, 004H, 004H 
072H, 003H, 006H, OB8H, OC4H , O80H , O80H, O80H ; O80H: 

073H,003H, 006H, 078H, 084H, 060H, 018K, 084H ,078H 

074H, 001H, 008H, 020H, 020H, OF8H, O20H, O20H, 020H, 024H, 018K 
075H, 003H, 006H, 084H, 084H, 084H ,084H, O8CH,074H . 

076H, 003H, 006H, 082H, 082H, O82H, 044H, 028H,, 010H 

077H, 003H ,006H, 082H ,092H ,092H;,092H,092H,06CH 

078H, 003H, 006H, 084H, 048H, 030H,030H,048H, 084H 

079H, 003H,009H, 084H, 084H, 084H, 084H, O8CH,074H, 004H, 084H, 078H 
O7AH, 003H, 006H, OFCH, 008H,010H,020H,040H, OFCH 

07BH, OOOH , 009H,018H, 020H ,020H, 020H,040H, 020H ,020H, 020H,018H 
07CH, OOOH, OO8H, 010H,010H,010H,O00H, OOOH, O10H,010H,010H - 
07DH, OOOH, 009H, O30H, 008H, OO8H, 008H, 004H, 0O8H, 08H, OO8H ,030H 
O7EH, 001H, 003H, 060H ,092H,00CH be 

07FH,001H, OO7H,OFEH,07EH, OOGH, O46H, OC6H, OFGH, OE2H 

O00H, OOOH, COOH 


; end of C_ Font 
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TITLE " CALEB 0.00 Configuration" 
FEAEEEE TEED EEE EEF EEE TEESE EEE EEE EEE EEEEREE EE EE EEE EEE EE EEE EEE EEE EEE EEE ET EEE EET 


C Config > | CALEB 0.00. 


This file contains the extra EEPROM copyright claim-as well as the 
serial port configuration data. The locations defined in this module 
currently assume that the extra EEPROM is a 27128 (i.e. 16 Kbytes). 


; 

‘ 

; 

? 3 

: Copyright 1985 Advanced Micro Devices, Inc. 
: i. 

: 

i 


NAME "Configuration" 


ExtraCpyRghtMsg | Resident claim in extra EEPROM 


GLB DblBaudOpt ; PCON contents 
GLB = BaudRatCnt ~ ; Timer one. value 


eee e eed eEEETTETETOUTVENENNEC TTTTTOTOCUNTOTOVET TNIV ETT TTT TTT TTTV OST ST ETETET 
ORG  O3FCOH 

ExtraCpyRghtMsg:. ; Resident claim in ee EEPROM 
DB " Copyright 1985 Advanced Micro Devices, Inc. " | 

Nee eee eeeeeeeeeeeece cc ceeceeaccctersterecsCretetrcece terse ccecceesttere oan , 


ORG O3FFOH 


Dbl BaudOpt: DB. =O00H 
BaudRatCnt: = DB  OFDH 


SEFELELEEE EEE EEE LEAL ELE LEE EAE EE EEE EEE EET EEE TEESE EEE ESTE EEE EEE EEE EEE EEE tt ttt ttt 


- 3 end of C Config 
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SEEEEEEEEEE EEE EEE EEE EEE EE EE EEE EEE E EEE EEE EEE ETT t ttt ttt Ett tt ttt FFF FFT FFF Tt tt ttt 


C_MemMap | CALEB 0.00 


Copyright 1985 Advanced Micro Devices, Inc. 


This file, which is included in the other source files, defines several 
‘constants of use in this implementation. It also defines the addresses 
of all. internal RAM variables, all external data structures required by 
the Am8052 and other external data control information. - 4 


s 
cd 
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- These are a few constants representing fundamental parameters of the system. 


s 


DBL_BAUD OPTION EQU OOOH 
RATE_9600 BAUD  EQU  OFDH 


N 


END FRM_CNT_HI  EQU OFEH 
END_FRM_CNT.LO —EQU. 


Some miscellaneous constants 


DEL EQU  O7FH 


SHEET EEE EEE EEE EE EEE EEE EE EEE EEE EEE EEE EEE EET ETE T Et ttt ttt ttt tt FFT PPh ttt ttt ttt 


SKIP ' 
SHEER EEE EE EEE EEE EEE EEE EEE EEE EEE EEE EEE E EEE EEE EE EEE E EEE EEE EEE TEE ET TET ETT 


The following define the structures used by the Am8052. The element symbol - 
is added to the address of the desired structure to obtain the address of 
the particular byte to be processed. . 


. 
a 
. 
f 
= 
# 


7; Main Definition Block — 


are 


MDB_xO0 
MDB_RowAdrHi 
MDB RowPag 
MDB_RowOff 
MDB_Cux 
MDB _Cuy 
MDB Fat 
MDB_FilChr 
MDB_Blnk 
MDB Scrl 
MDB VrtVec 
MDB_ScrlVec 
MDB Tslc 
MDB x13. 


ORMNAURWN=O 


— hme 
Nn = © 


; Window Definition Block 


WOB_Scw 
WOB_RowAdrHi 
WDB_RowPag 
WOB_RowOf f 
WDB_x4 
WDB_NxtAdrHi 
WDOB_NxtPag 
WOB_NxtOff 
WDB_BgnRow 
WDB_EndRow 
WDB _BgnCol 
WDB_EndCol 


EQU 
EQU 
EQU 
EQU 
EQU 


-EQU 


EQU 
EQU 
EQU 
EQU 
EQU 


; Row Control Block 


RCB_RdfLnk 
RCB_RowAdri 
RCB_RowPag 
RCB_RowOf f 
RCB_Seg 


EQU 


EQU 
EQU 
EQU 
EQU 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


me ™e Se Se Be MH MH MH lH Dl lH lM lS 
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Unused in linear address mode 
Unused high byte of 24-bit address 
Page .of top visible background row. 
Offset of top visible background row 
Horizontal position of cursor 


Vertical position of cursor 


Fetch fill attribute flag 

Fill character code 

Blink control fields. 

Smooth scroll control fields 
Vertical interrupt vector 

Smooth scroll interrupt vector 

Scan line count for top visible row 


Scroll window flag 

Unused high byte of. 24-bit address 
Page of top visible window row 
Offset of top visible window row 
Unused in Linear address modé 
Unused high byte of 24-bit address 
Page of next window definition block 
Offset of next window definition blk 
Window placement first row 

Window placement last row: 

Window placement first column 
Window placement last column 


‘Link to row redefiniton block flag: 


Unused high byte of 24-bit address - 
Page of next row control block 
Offset of next row control block — 
Start of segments 
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RCB 1st" 
RCB_ 2nd 
RCB. 3rd 
RCB 4th 


NOTE: 


14 
24 
34 


« 
a 
. 
ti 
. 
rf 
. 
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Start of first segment (= RCB_Seg) 
Start of second segment (if present) 
Start of third segment Cif present) 


Start of fourth segment (if present) 


The segment element symbol (defined below) is added to the element 


symbol defining the start of the desired segment (defined above). 


SEG _NumHid 


-SEG_NumVis 


SEG Cont 


-SEG_ChrAdrHi 


SEG ChrPag 
SEG_Chroff 
SEG_x6 


“SEG _AtrAdrHi 


SEG AtrPag 
SEG AtrOff 


NOTE: 


=e “es Se SS 


RCB_x44 


 RCB_BgdRdfAdrHi 


RCB_BgdRdfPag 
RCB_BgdRdfoff 


RCB_x26 
RCB_MsgRdfAdrHi 
RCB_MsgRdfPag 


RCB_MsgRdfOf f 


RCB_x16 


RCB_WndRdfAdrHi 


RCB_WndRdfPag 
RCB_WndRdfOf f 


block. 


EQU 
EQU 


 EQU 


EQU 
EQU 
EQU 
EQU 
EQU 


“EQU 


EQU 


EQU 
EQu 
EQU 
£QU 


EQU 
EQU 
EQU 
EQU 


EQU 


~ EQU 


EQU 
EQU 


s 
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44 
45 
46 
47 


24 
25 
26 


27 


16 


15 


17 


The element symbol for the row 
end of each row control block) depends on the type of row control 
Each display has a different size row control block (i.e. 
ied have different numbers of 


é 
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Number of hidden chars in this seg 
Number of visible chars in this seg - 
Continue flag (set if a seg follows) 
Unused high byte of 24-bit address 
Page of this seg's character buffer 
Offset of this seg's character buffer 
Unused in linear address mode 

Unused high byte of 24-bit address 
Page of this seg's attribute buffer - 
Offset of this seg's attribute buffer 


redefinition block pointer (at the 


segments). 


=e “es “Se SS 


=s. me =e =. 


=e ws Gl CW 


Unused in linear address mode 
Unused high byte of 24-bit address 
Page of redef block for bgd RCBs 
Offset of redef block for bgd RCBs 


Unused in linear address mode 

Unused high byte of 24-bit address 
Page of redef block for message RCB 
Offset of redef block for message RCB 


Unused in linear address mode 
Unused high byte of 24-bit address 


-Page of redef block for window RCBs 
‘Offset of redef block for window RCBs 


sRCB_x16 


RCB_ClirRdfAdrHi. 


RCB_CirRdfPag 
RCB_Cirrdfoff 


(already defined) 


EQU 
EQU 


15 


: Row Redefinition Block 


RRB_Tslc_NcsHi 
RRB_NcsLo Nce 
RRB_ApHi_SpcsHi 
RRB_SpcsLo_Spce 


~ RRB_ApLo_SbcsHi 


RRB_SbcsLo_Sbce 
RRB_CursHi 
RRB_CursLo Cure 
RRB_Dr_UndHi 
RRB_UndLo_Sund 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


EQU . 


EQU 
EQU 


OC ONKURW DH = © 
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=e Se Se Be Me BMH BH MR we Hw 


Rest 
Part 
Rest 
Rest 
Rest 
Part 
Rest 


li 


Unused in linear address mode 

Unused high byte of 24-bit address 
Page of redef blk for clr font RCBs 
Offset of redef blk for clr font RCBs 


ne count/part of normal char start 


of normal char start/normal char end 
of row attrs/part of superscript start 
of superscript start/superscript end 
of row attrs/part of subscript start 
of subscript start/subscript end 


of 
of 


cursor start - 
cursor start/cursor end 


Double height flags/part of underline 
Rest of underline/shifted underline 


SEELEEEELE EEL E EEE EE EEE EE EEE FETE EEE TTT ETE EEE EE EEE TEETH EEE ttt t ttt ttt ttt 


SKIP 


SEEEEEEEEE EEE ELE FEE EE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EE EEE E EE EEE Et ttt ttt tt 


Internal RAM Variables 


The definitions of the internal RAM variables are given below. 


These are 


used for all control values during normal operations on the active display 


and also for all system wide controls. 


Variables used for fundamental system operations are defined here. 


StkBas 


EndFrmf lg 


. Am8052BusReqF lg 


Am8052BusAckFlg 


DATA O67H 


BIT 


BIT 
BIT 


OOcH 


P3.2 0 


P1.2 


e 
’ 


Base of stack 


Set by timer 0 (end-of-frame) intr 


Low when Am8052 wants bus (INTO*) 


“Cleared to give bus to Am8052 
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MemTstTmp DATA 0O10H 3 Used only during memory tests HstRcevCnt DATA Number of chars received from host 
HstRcevInsOf f DATA - Place to insert next char into ring 


HstRcvExtOf f DATA Place to extract next char from ring 


The variables that are used for dispatching control to the various control NEAR_FULL_CNT EQU. 3 Stop if. less space remaining . 
routines and special purpose routines (e.g. graphic character placement) NEAR_EMPTY_CNT EQU. 12 Start if fewer characters available 
are defined below. The dispatcher is also responsible for parsing control : : : : 

sequences and decoding parameters. | % ; NOTE: The actual host reception buffer is too large to place in internal ~ 
: RAM, so it is defined (later in this file) in external data mémory. 


; Current state of dispatcher 
: (the states are defined below) HstRcvBsyFlg BIT P1.6 ; Set if too busy to rcv, clear if rdy 
. Direct (single-char level) , >: NOTE: This signal is inverted by 
Escape sequence (after ESC) - . the RS232 drivers so that 


DisStt ‘DATA O10H 


DIR_CHR_STT - EQU 00H 
BGN_ESC_STT - EQU 003H 
EXT_ESC_STT  EQU  006H 
BGN CSI_STT EQU 09H 
PRM_CSI_STT = EQU . OOCH 
EXT_CSI_STT EQU  OOFH 
UNIMPCSI_STT EQU - 012H 


Extend ESC seq (w/intermediate) a positive level indicates 
Control Sequence (after CSI) ready, negative level means 
Sequence (params in CSI seq) don't send chars from host 
Extend CSI seq (w/intermediate) ‘ 
Unimplemented (but valid) seq NOTE: There is currently no software. support for the following variables. 

: They have only been defined for possible extensions. The affect 
these new capabitities would have on existing operations, and any 
necessary restrictions on their use, will need to be considered. 


=e =e “Ss Ss Se We =e 


PrmAcc DATA 0O11H _Temporary parameter accumulator | 
PrmPvt DATA 012H Private parameter string introducer 
PrmRep DATA 013H Special. repeat (first) parameter ; 
“PrmCnt _ DATA O14H +. 3 Number of parameters in sequence © ‘HstXmtFlg BIT. O17H ; Semaphore to lock out keyboard source 
PrmMaxF lg > BIT — OOFH , ‘Set when parameter buffer overflows ; characters while a software source | 
PrmBadFlg BIT OOEH © Set when a bad parameter is decoded : sequence is being transmitted 
PrmBgnFlg- BIT  OODH Set when beginning parameter string 
PrmBuf DATA O4EH Decoded parameters HstXmtCnt. DATA ~ 025H 
- PRM_CNT_MAX. EQU. 18 Maximum number of: parameters allowed HstXmt InsOf f DATA O026H 
CtlPtri . DATA 016H Address of control or special HstXmtExtOf f DATA 027H 
CtlPtrLo ; routine last executed (for REP) HstXmtBuf ‘DATA 064H 


=e =e =e =e 


Number of chars to send to host | 
-Place to insert next char into ring 
Place to extract next char from ring 
Host transmission ring buffer - 


=e Se Be GS 


Set when host is too busy to receive 
NOTE: This signal is inverted by 
- the RS232 drivers so that. — 
_- @ positive level indicates 
ready, negative level means 
don't send chars to host 


HstXmtBsyFlg --BIT._—wP1.7 


These variables maintain the communications ring buffers. Three buffers 
are defined: a host reception buffer for characters from the host, a host 
transmission buffer for characters being sent to the host, and a keyboard 
reception buffer for characters from the keyboard. 


=e Se =e =e |p @e 


aR 
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KbdRcevCnt 


ActCol DATA 030H 


" BgnRow DATA 035H 
TopRow DATA 036H 
" BtmRow DATA 037H 


Number of chars received from keybrd 
Place to insert next char into ring 
Place to extract next char from ring 
Keyboard reception ring buffer 

Set when char ready from keyboard 


KbdRcvinsOf f 
KbdRcvExtOf f 
KbdRcvBuf 

KbdRcvRdyF lg 


These are. the display dependent variables. The first twelve are those which 
must be copied out to and in from external data memory with each change of 
the active display. An index variable is one which represents a zero origin 
count from the beginning of something, a page variable contains a page 
address, an offset variable contains an offset into a page and a-count 
variable represents a quantity (counting from one). 


=e Be =e Be Be Wa 


Attribute byte written to memory 
(composed of the following bits) 

Highlight 

Reverse 

Superscript 

Subs¢ript 

Strike-out (shifted underline) 

Underscore 

Blink 


CurAtr ' DATA O2FH 


LitBit — BIT  O7EH 
RevBit ‘BIT 07DH 
SpsBit BIT O7CH 
SbsBit BIT ‘ O7BH 
SundBit - BIT O7AH 
UndBit _ BIT O79H 
BLnkBit BIT . 078H 


“=e 8 Ss Se Se ws we 


Active position horizontal (index) 
Active position vertical (index) 
Active row control block (page) 
Horizontal scroll position (index) 
Vertical scroll position (index) 
First RCB in display (page) 

First visible RCB (page). 

Last visible RCB (page) 

Remaining RCBs below. BtmRow (page) 
Last RCB in display. (page) 

Extra row (page) 


ActRow © DATA 031H 
CurRow DATA 032H 
VisCol DATA 033H 
VisRow DATA 034H 


RemRow DATA 038H 
EndRow DATA 039H 
ExtRow DATA O3AH 


=e =e =e =e =a =e =e =e =e =e =e 


RowAdd DATA O3EH 


TrmRow DATA 


: The remaining display dependent variables are not opie: They are set 
: after each change of active display. 


Visible width of display (count) 
Visible height of display (count) 


DspWid DATA O3BH 
DspHgt .. DATA O3CH 
ColAdd DATA O3DH Aids horz. cursor placement (index) 
Aids vert. cursor placement (index) 
RcbOf f . DATA O3FH 
Chroff DATA 040H 
Atroff DATA 041H 


‘Offset of display's RCBs (offset) 
Offset of character buffer (offset) 
Offset of attribute buffer (offset) 


Termination RCB (page) 
Termination RCB (offset) 


: The following variables are used to control various special features. The 
; first two are used to switch between two definition blocks in Support of 
3 the Am8052 vertical smooth perone feature. 


CurMDBFlg ~ BIT OOOH . 
CurWOBF lg BIT OO1H 


Set when alternate MDB is current 
Set when alternate WOB-is current. 


: This group supports the message and window displays. 


MsgActFlg BIT  0O04H ; Set when message display is active 
MsgVisFlg BIT  O05H s Set when message display is visible 


WndActFlg BIT  O0O6H 3; Set when window display is active 
WndVisFlg — BIT ; Set when window display is visible 


WndCol ‘DATA Current bgd col of left window bound 
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_HrzFrmSet DATA O47H 


a 


; The next group supports vertical and horizontal smooth scrolling. 


Number of rows to scroll. 

Used for new-line: scrolling 

Image of byte written to the MDBs 

_ (composed of the following bits) 

‘Four bit field holding current 
smooth scroll rate (normally 
the rate ‘is changed by mask 
and these names are unused) 

Wnd/bgd vert smooth scroll 

Up/down vertical smooth scroll 

Set during vert smooth scroll 

Mask for manipulating scroll rate 

Number of characters to scroll 

Number of frames per scroll | 

Number of frames until next scroll 

Number of pixels each scroll 

Current pixel shift 

Set when scrolling message display 

Set when scrolling right 

Set. while doing horz smooth scroll 


VrtScrlCnt DATA O45H 
VrtScrlNewFlg =~ BIT OOBH 
ScrlByt DATA O02DH 


=n bl se ms 


Sr3Bit BIT O6EH ; 
Sr2Bit ; BIT O6DH ; 
SriBit BIT: O6CH ; 
SrOBit BIT = O6BH ; 
SwbBit BIT O6AH : 
SudBit BIT  O69H 7 
VrtSerlFlg BIT  068H : 
SCRL_RAT MASK  EQU O78H 
HrzSerlCnt DATA 046H 


HrzFrmCnt DATA 048H 
HrzPxtShf - DATA 049 
HrzCurPxl DATA O4AH 
HrzDspFlg BIT OOAH ~ 
Hr2zDirFlg BIT  OO9H 
HrzSerlFlg : BIT O0O8H 
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3 The following flag is used to indicate the current font selection for 
; remapping character codes to character font cell addresses. 

FntMapF lg BIT 014H : Set when alternate font selected 
SKIP 


; The next two variables support the alterable cursor appearance and character 
y; blink features. ae me 


CsrSiz . ; Cursor start/end Lines (in nibbles) 
BlnkByt ; Image of byte written to the MDBs 
: (composed of the following bits) 
ChcBit ; Character blink duty cycle 
ChbBit1 + Character blink rate high and- 
ChbBitO : low bits (two-bit field) 


CatbeBit BIT 074H ; Attribute cursor blink enable 
CxybeBit BIT  O73H ; X-Y cursor blink enable 
CudBit ; BIT 0O72H . ; Cursor blink duty cycle _ 

; Cursor blink rate high and 

; 


low bits (two-bit field) 


CubBit1 BIT O71H 
CubBi tO BIT- O7OH 


; These aid in cursor placement in the special advance cursor code used 
; after placing a character/attribute in display memory. 


Set when cursor is in a visible zone 
Amount cursor may be advanced until - 


CsrZonFlg BIT O10H : 
, 
: it moves into the next zone 
Ps 
’ 


CsrZonCnt DATA 015H 


CsrShwFlg BIT O11H 
CsrSetFlg BIT 012H 


Defers showing the cursor until © 
second vertical retrace time. 


s 


: The following support the modes which are software selectable. 


ModByt DATA O2CH : Provides byte access to modes 
VEMBit BIT  067H 
AMDDWMBit & ' BIT O66H 
AMDSCMBit BIT 065H 
AMDSPMBit BIT P1.1 


Vertical editing (downward/upward) 
Display width (normal/compressed) 
‘Scroll (normal jump/smooth) 

Screen polarity (normal/reversed) 

: (not part of regular mode byte) 
THERE EEE EEE EEE EEE HEHE EEE EEE EEE HEHEHE EEE EEE EEE EEE 
SKIP . 
ToC EEE HEHEHE HEHEHE HEHEHE HEE EEE 


e S28 Ss “ses &e 
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; The following address is used when accessing the keyboard. It is only 
; possible to read from the keyboard. 


Keybrd XDATA 00001H ; Read character from keyboard 

The keyboard is enabled by holding a high level on-a port 1 pin. When 
there is a character available from the keyboard, this fact is signalled 
by a high level on another port 1 pin cconaunee for input). The two 


pins are defined below. a 


. 
" 
. 
e 
. 
gs 
. 
cf 


KeybrdEnbF lg BIT P1.4 3; High level enables the keyboard 


4 
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Vertical Total Lines 

Horz Sync Width/Vertical Event Row 
Horizontal Drive 

Horizontal Scan Delay 

Horizontal Total Count 

Horizontal Total Display 


; $EEEEEEEEEEEEEEEE EEE EEEEEEEEE EEE EEE EERE EEE EEE EEE EEE EEE EEEEEEEEEE EEE EEE EEE VrtTotLnelInd . _ EQU 013H 
SKIP HsyncVintInd EQU  014H 

; TEEFEEEL EET EEEE EEE ET EEE EE ETE EEE EEE EE EEE EEE TEETH EE ETE E TEE E ETE ETE TEE tet HDrvI nd ; EQU 015 H 
; HScnDlyInd EQU O16H 
The following addresses are used in accessing the Am8052 registers. The HTotCntInd EQU§ O17H 
order of operations is critical. First, regardless of access type, the _HTotDspInd EQU 018H 


; 

: 

3. register number should be written to the Am8052 register pointer. Then _ 

; to write toa register, the high byte of the 16-bit register value must ZEEEEEEEF EEE E FEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEE EEETEEEEEFEEEEEE ESET E EEE EET 
; 

P 
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be written first followed by the low byte. To read from a register, the SKIP 
low byte must be read first followed by the high byte. SEEEEEEEELELEEEEEE EEE EEE FEE EEE EEF EEEEE EEE EEEEEEEEEE EEE EEE EEE EEE EEE EEE 4444444 


The following are the locations of the structures used during normal Am8052 
operations. There are three displays: background, message and window. The 
background display is implemented as the: Am8052 background and the others 
are implemented as Am8052 windows. The latter can be enabled (made visible) 
or disabled (made invisible). Structures to support these displays, as well 
as others to support vertical smooth scrolling, horizontal smooth scrolling 
and a loadable character font are all allocated at fixed locations and _ 
initialized following the reset/self-test procedure and after the character 
generator RAM has been initially cleared. . 


Am8052Ptr XDATA 04003H : Address of pointer register 
Am8052RegHi XDATA QO4000H - 3 Address of high byte of data register 
Am8052RegLo XDATA 04001H : Address of low byte of data register 


y When reading or writing the Am8052, its address strobe (AS*) must be held 
; low. This is accomplished by clearing the port 1 pin which is connected 
: to it before beginning the access and setting this pin when finished. 


Am8052XfrFlg BIT P1.3 ; Connected to Am8052 pin AS* 


The background display contains 30 rows of 128 characters each. In normal 
mode, only 24 rows of 80 characters each are displayed. In compressed mode 
all 30 rows, but only 120 characters, are shown. The undisplayed characters 
are stored in display memory and can be viewed by scrolling. The background 
display can be scrolled both vertically and horizontally. There is also an 
extra row to support vertical smooth scrolling. 


; The register numbers which are written to the Am8052 pointer register are 
; defined below. 


Mode Register 1 

Mode Register 2 

Attribute Port Enable 

Attribute Redefinition 

Top of Page Soft Pointer (hi word) 
Top of Page Soft Pointer (lo word) 
Top of Window Soft Pointer (hi word) 
Top of Window Soft Pointer (lo word) 
Attribute Flag 

Top of Page Hard Pointer (hi. word) 
Top of Page Hard Pointer (lo word) - 
Top of Window Hard Pointer (hi word) 
Top of Window Hard Pointer (lo word) 
DMA Burst and Space , 
Vert Syne Width/Vert Scan Delay Reg 
- Vertical Active Lines 


ModReg1 Ind 
ModReg2Ind — 
AtrEnbInd 
AtrRdfiInd 
TOPStHi Ind 
TOPSftLoInd 
TOWSftHi Ind 
TOWSftLoInd 
AtrFlgInd 
TOPHrdHilInd 
TOPHrdLoInd 
TOWHrdHi Ind 
- TOWHrdLoInd 
DMABstInd 
VrtWthInd 
VrtActLnelInd — 


The message display has a single row of 128 characters. Like. the background 
display, 80 characters are shown in normal mode (provided the message display 
is enabled) and 120 characters are visible in compressed mode. The message 
display can be scrolled horizontally to view all of its characters. Since 

it is not vertically scrollable it has no need for an extra row. The message 
display is implemented as an Am8052 window placed at the lowest row on the 
monitor screen. 


me =e =a =e =e =a =s =a =e “6 
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The window display has 14 rows of 40 characters each. Regardless of mode, 








: : teeceeeee $--- eee ee eee eeee Hernan eee ee ee ween eee oe: 
s only 7 rows and all 40 characters are shown. It can be scrolled vertically ; 80B0-> | | | | WWDBO | 
: to view all of its rows. It cannot be scrolled horizontally: When enabled, . | | i Herne ee eee + 
: it is shown near the,upper right corner of the monitor screen with portions ; 81B0-> | | | | | wwoB1 | 
: of the background display surrounding it. : | j | toner cee eeee + 
aS ies ; 82B0-> | | | |  MWDB | 
SKIP. ; [. | | Hacer eee eeee + 
; ; | 7 ; 83B0-> | | | | TwoB -| : 
; Memory allocation is shown diagramatically in the figures below. ; | | | $rte => see bet 
os 8 ; 84B0-> | | | | NRRB- [#| 
fo beeeeeeeetecbteeeseceeeeseeteceerseseeneees beseeccseeereeseeses ‘ | |. feeeeseecctet 
; .8000-> | | | | ; 85B0-> | | | | DNRRB~ {x} 
Pe : : i. 35 : i | | Peesceeee +-+ 
i | | | | ; 86B0-> | . | |. | SURRB |x| 
: | BRCBO | BCHRO. mae ee : | FRRBO | WRCBO - | WCHRO eicteomda: aoa 
77 | Sad : : | (see next figure) | ; 87B0-> | : | ; i : | SLRRB |x| 
; | BRCB30 | BCHR30 cfs 5 | : | FRRB14 | WRCB14 | —WCHR14. ees he ey 
i £ | | | ; 8880-> | vail | [--DURRB |x| _ 
; : ae : : ; | |. | oeeeee cot bet 
ae | | | | ; 89B0-> | | | | DLRRB- |x| 
; 9E00-> | | | | | st | | | $occceeee- +-+ 
; ee ot Se eee + | ; 8ABO-> | . | | | Bm | 
; 9FOO-> | MRCB |*|**| - MCHR | | ed | — | bee cte tenet 
7 to----- eee Hoot reese eceee ee eee + ; 8BB0-> | | | [BTR|xx] WTB| 
; A0OO-> | | a? 3 | | | ; ee ee os 
: | | ; 8CBO-> | | | : | BGDVARS | 
i | | 7 [ | | Seceensere ss + 
: | BATRO | ; 8DB0-> | i | | MSGVARS | 
8 a = | , | Pas al jo | becsesecceect 
: | BATR30 - | ; 8EBO-> | | | | WNDVARS- |. 
: : : . Poche pa icin ae a eee ea cies reece ste mere 2 ew weet cece 5 la + 
tae | “7 8FBO-> | | i HRCV ae 
; BEOO-> | | ae sea ace aca tl  ce icle ca aise 8S eaieie water ae aes + 
: ns + ; 90B0-> | WATRO | 
; BFOO-> | oe MATR ~ | ; | . : | 
4 o> dpteceseate Scan abcde ie vasceadessase es ieee vse var vece ess aebeees + : | WATR14 | 
as ‘* + message function character (1 byte), ; GEBO-> | - ee ae 
- message active count (1 byte), i ee a See Wana ae See hese =: ser ees ‘eee ae 
; ; message function attribute (2 bytes) z 9FBO-> | BMDBO | BMDB1 sha Calle | BACT - | WACT = | 
F ig message tab table (16 bytes). 3 (pee eee rcee ee Rae ee Ae OS ere teres sce) oe Pe taeda Seca tial ate + 
5 vo : * = two background function characters (2 bytes) 
. Bes two background function attributes (4 bytes) 
; # _- one termination blank attribute (2 bytes). 
: x -.- unused (13 bytes total) —_ 
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PAGE © vo EQU 8 
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BgdMDBO 
BgdMDB1 
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These are the definitions used for all display memory. They are related to 
-the actual, physical parameters of our external data RAM (i.e. amount and 
location). .In this implmentation, display memory is organized as 64 pages © 
of 256 bytes each. This is the easiest way for the Am8751 processor to 
treat external data. Each byte has an address consisting of two components, 
its page and its offset within that page. By allocating similar structures 
at the same offset in different pages, and guaranteeing that none of them 
-¢ross a page boundary, we are able to manipulate addresses one byte at a 
time. This is important since the processor has no 16-bit arithmetic 


operations. 


XDATA 08000H ; Base of external (display) memory 


spMemBas 


Number of bytes of external memory: 
Number of bytes in a page of memory 


04000H 
00100H 


SP.MEM SIZ —- EQU 
AG SIZ EQU 


Shift right by this value extracts a 
page address from a 16-bit addr 
Mask (and) with this value extracts 


OOOFFH 
: an offset from a 16-bit address 


-Here we define the main definition blocks. These control operations that 
‘can be changed from one frame to the next. We need two of them to switch 
‘between when doing a vertical smooth scroll of the background display. 
Parameterizes the background display 
(and supports smooth scrolling) 


XDATA. O9FBOH ; 
XDATA O9FBEH ; 


Next we define the four window definition blocks in the system. These 
control Am8052 window operations. There are two of them to switch between 
when doing a vertical smooth scroll of the window display. Another is used 
for the message display.. The last one is used to terminate the Linked list 
of window definition blocks (as required by the Am8052). 


XDATA 
XDATA 


XDATA 


XDATA 


O80F4H 


081F4H 
O82F4H 


O083F4H 


. 
ri 
= 
a 
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Parameterizes the window display 
(and supports smooth scrolling) 


Parameterizes the message display 


; Terminates the list of WDBs 


; These are the row control blocks for the background display. There are 31 
: of them, one for each displayable row and an extra one for use with the 
; insert and delete line controls and bottom-of-display scrolling. 


BgdRCBO 
BgdRCB1 
BgdRCB2 
BgdRCB3 
BgdRCB4 


-BgdRCB5 


BgdRCB6 

BgdRCB7 

BgdRCB8& 

BgdRCB9 

BgdRCB10 
BgdRCB11 
BgdRCB12 
BgdRCB13 
BgdRCB14 
BgdRCB15 
BgdRCB16 
BgdRCB17 
BgdRCB18 
BgdRCB19 
BgdRCB20 
BgdRCB21 
BgdRCB22 
BgdRCB23 


XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


XDATA 


XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


08000H 
08100H 
08200H 
08300H 
08400H 
08500H 
08600H 
08700H 


O8800H . 


08900H 
G8AC0H 
O8BO0H 
O8COOH 
O8DO00H 
O8E00H 
O8FOOH 
09000H 
09100H 
09200H 
09300H 
09400H 
09500H 
09600H 
09700H 


. 
’ 
s 
s 
. 
td 
. 
f 
s 
f 
. 
’ 
. 
f 
s 
ti 
. 
f 
Ld 
f 
e 
a’ 
. 
Z 
e 
' 
2 
a 
. 
’ 
e 
f 
e 
s 
. 
a 
2 
s 
. 
f 
s 
s 
a 
a 
e 
ti 
* 
a 


NOTE: 


Each row control block 

is at the same offset in 
different pages. They are 
named for their order in 
memory. Their apparent 
order (i.e. as they are 
shown on the monitor) will — 
depend on the linked list 
pointers they contain. 


This order will change 


during normal operations 
as a result of inserting 
and deleting rows. The 
order will also be changed 
by bottom-of-display 
scrolling. 


There is a correspondence 
between a particular row 


-control block and the same 


numbered character and 
attribute buffers. This 
correspondence is kept in 
spite of any logical order. 
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BgdRCB24 


~ BgdRCB25° 


BgdRCB26_ 
BgCRCB27 
BgdRCB28 
BgdRCB29 
BgdRCB30 
BGD_BUF_WID 


. 
f 


BgdChrBuf0 
BgdChrBuf 1 
BgdChrBuf2 | 
BgdChrBuf3 
BgdChrBuf4 
BgdChrBuf5 
BgdChrBuf6 
BodChrBuf7 


. BgdChrBuf8 


BgdChrBuf9 
BgdChrBuf 10 
BgdChrBuf 11 
BgdChrBuf 12 
BgdChrBuf 13 


BgdChrBuf 14 


BgdChrBuf 15 
BgdChrBuf 16 
BgdChrBuf 17 
BgdChrBuf 18 
BgdChrBuf 19 


. BgdChrBuf20 


BgdChrBuf21 


BgdChrBuf22 - 


BodChrBuf23 
BgdChrBuf24 
BgdChrBuf25 


BgdChrBuf26 


BgdChrBuf27/ 
BodChrBuf28 


_BgdChrBuf29 


BgdChrBuf30 


ait 


XDATA 09800H — 


XDATA 09900H 
XDATA O9A00H 
XDATA O9B00H 
XDATA O9COOH 
XDATA O9DO0H 
XDATA O9EOOH 
EQU = 128 


XDATA 08030H 
XDATA 08130H 


XDATA: 08230H - 


XDATA 08330H 
XDATA 08430H 
XDATA 08530H 
XDATA 08630H 
XDATA 08730H 
XDATA 08830H 
XDATA 08930H 
XDATA O8A30H 
XDATA 08B30H 
XDATA 08C30H 
XDATA 08D30H 
XDATA O8E30H 
XDATA O8F30H 
XDATA 09030H 
XDATA 09130H 


__XDATA 09230H 
~ XDATA 09330H 


XDATA 09430H 
XDATA 09530H 
XDATA 09630H 


-XDATA 09730H 


XDATA .09830H 
XDATA .09930H 
XDATA O9A30H 
XDATA 09B30H 


 XDATA O9C30H 


XDATA 09D30H 
XDATA O9E30H 


g 


These are the character buffers for the bac 
s for each row control block and each contains 128 characters. 
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Therefore, the characters 
and attributes. which are 
refered to by a particular 
row control block can be 
easily determined at any 
time. 


Width of background (and message) 


NOTE: 


display buffers 
kground display. There is one 





Each buffer is at the same 

offset in different pages. 

Each is in the same page as 
the row control block which 
refers to it. 














These are the attribute buffers for the background display. There is one 


; for each row control block and each contains 128 attributes. 


BgdAtrBuf0 
BgdAtrBuf1 


BodAtrBuf2 © 


BgdAtrBuf3 
BgdAtrBuf4 
BgdAtrBuf5 
BodAtrBuf6 
BgdAtrBuf7 
BgdAtrBuf8 
BgdAtrBuf9 
BgdAtrBuf 10 
BgdAtrBuf11 
BgdAtrBuf 12 
BgdAtrBuf 13 
BgdAtrBuf 14 
BgdAtrBuf 15 
BgdAtrBuf16 
BgdAtrBuf17 
BgdAtrBuf 18 
BgdAtrBuf 19 


BgdAtrBuf20 


BgdAtrBuf21 
BgdAtrBuf 22 
BgdAtrBuf23 
BgdAtrBuf24 
BgdAtrBuf25 
BgdAtrBuf26 
BgdAtrBuf27 
BgdAtrBuf28 


. BgdAtrBuf29 


BgdAtrBuf30 





XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


OAOCOOH 


OA100H © 


0A200H 
0A300H 
OA400H 
OA500H 
OA600H 
OA700H 
OA800H 
0A900H 
OAAOOH 
OABOOH 
OACOOH 


OADOOH © 


OAEOOH 
OAFOOH 
OBOOOH 
0B100H 
OB200H 
OB300H 
0B400H 
OB500H 
OB600H 
OB700H 
OB800H 
OB900H 
OBACOH 
OBBOOH 
OBCOOH 
OBDOOH 
OBEOOH 


. 
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NOTE: 


Each buffer is at the same 
offset in different pages. 
Each isin a page which. is 
32 pages beyond the page 
containing the row control - 
block which refers to it. 
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This is the row control block for the message display. Only one is needed 
since the insertand delete line controls and vertical scrolling are not 
allowed in this display. 


MsgRCB 


s 
f 
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MsgChrBuf 


. 
’ 
. 
as 
. 
8 


MsgAtrBuf 
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WndRCBO 
WndRCB1 
WndRCB2 
WndRCB3 
WndRCB4 
WndRCB5 
WndRCB6 
WndRCB7 
WndRCB8 
WndRCB9 
WndRCB10 
WndRCB11 
WndRCB12 
WndRCB13 
wndRCB14 


XDATA 


XDATA 


XDATA 


XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


~ XDATA 


XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


O9FOOH 


O9F30H 


OBFOOH 


O80BAH ° 


O81BAH 
082BAH 
O83BAH 


O84BAH. 


-085BAH 
O86BAH 
087BAH 
O88BAH 
O89BAH 
O8ABAH 
O8BBAH 
O8CBAH 
O8DBAH 
O8EBAH 
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NOTE: 


This is the character buffer for the message display. It is at the same 
offset as the background display character buffers and is in the same page 
as its row control block. , 


This is the attribute buffer for the message display. It bears the same 
relationship to its row control block as the background attribute buffers 
bear to their row control blocks (i.e. 32 pages beyond it). 


These are the row control blocks for the window display. There are 15 
of them, one for each displayable row and an extra one for use with the 
insert and delete line controls and bottom-of-display scrolling. 


Each row control block 


‘4s at the same offset in 


different pages. They are 
named for their order in 
memory. Their apparent 
order (i.e. as they are 
shown on the monitor) will 
depend on the linked list 
pointers they contain. 
This order will change 
during normal operations 
as a result of inserting 
and deleting rows and by 
bottom-of-display scrolling. 


» I 


WND_BUF_WID 
WND VIS WID 
WND_VIS_HGT 
WND_TOP_MRG 


SKIP 


WndChrBuf0 
WndChrBuf 1 
WndChrBuf2 
WndChrBuf3 
WndChrBuf4 
WndChrBuf5 


WndChrBuf6 ~ 


WndChrBuf7 
WndChrBuf8 
WndChrBuf9 
WndChrBuf 10 
WndChrBuf 11 
WndChrBuf 12 
WndChrBuf 13 
WndChrBuf 14 


. 
a 
. 
ti 


WndAtrBuf0O | 


WndAtrBuf 1 
WndAtrBuf2 
WndAtrBuf3 
WndAtrBuf4 
WndAtrBuf5 
WndAtrBuf6 
WndAtrBuf7 
WndAtrBuf8 
WndAtrBuf9 


WndAtrBuf 10 


WndAtrBuf 11 
WndAtrBuf12 


WndAtrBuf13 


WndAtrBuf 14 


\ 


XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


. XDATA 


XDATA 
XDATA 


XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


O80CCH 
081CCH 
O82CCH 
O83CCH 
O84CCH 
O85CCH 
O86CCH 
087CCH 
O88CCH 
O89CCH 
O8ACCH 
O8BCCH 
O8CCCH 
O8DCCH 
O8ECCH 


090B0H 
091B0H 
092B0H 
093B0H 
094B0H 
095B0H 


O96B0H | 


097B0H 
098B0H 
099B0H 
O9ABOH 
O9BBOH 
O9CBOH 
O9DBOH 
OSEBOH 
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Width of window display buffers 
Width of visible window display 
Height of visible window display 
Background rows above window display 


These are the character buffers for the wnidow display. There is one 
for each row control. block and each contains 40 characters. 


NOTE: Each buffer is at the same 
; offset in different pages. 
Each is in the same page as | 
the row control block which 
refers to it. — 


These are the attribute buffers for the window display. There is one 
for each row control block and each contains 40 attributes. 


NOTE: Each buffer is at the same 
offset in different pages. 
Each is in a page which is 
16 pages beyond the page 
containing the row control 
block which refers to it. . 
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‘These are the row redefinition blocks used during normal operations. They 
control the vertical placement of characters and attributes within the 
character row. In particular, a change of cursor appearance requires a 
change of the cursor start and end lines. . 7 


DwNhRRB 


SwUhRRB . 


SwWLhRRB 


DwUhRRB 


DwLhRRB © 


XDATA O84F4H 


_; Normal row redefinition block 


Only the preceding definition has current software support. The 


following definitions are for possible extensions to support rows 
of double width and/or double height characters. How these extra 
capabilities would affect existing operations, and any necessary 
restrictions on their use, will need to be considered. 


XDATA 


XDATA. 


XDATA 
XDATA 
XDATA 


O85F4H 
O86F4H 
087F4H 
O88F4H 
O89F4H 


Double width/normal height 

Single width/upper half of dbl height 
Single width/lower half of dbl height 
Double width/upper half of dbl height 
Double width/lower half of dbl height 


These are the row redefiniton blocks used for loading the character 
generator (font) RAM during normal operations. There is one for each 
slice of a character cell which can be programmed by a user. 


FntRRBO - 
FntRRB1 
FntRRB2 - 
FntRRB3 
FntRRB4 


“FntRRB5 
‘FNtRRB6 


FntRRB7 


.FntRRB& 
-FntRRB9 
FntRRB10: 
‘FntRRB11 


FntRRB12 
FntRRB13 
FntRRB14 


XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 
XDATA 


_ XDATA. 


XDATA 
XDATA 
XDATA 


080B0H 
081B0H 
082B0H 
083B0H 
084B0H 
08580H 
086B0H 
087B0H 


O088B0H 


08980H 
O8ABOH 
O8BBOH 
O8CBOH 
O8DBOH 
O8EBOH 
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NOTE: 


A user is only allowed to 
change the first fifteen 
slices of a character cell. 
This 1s because the Am8052 
requires that the last slice 
be cleared for use above and 


below the lines specified 


in the row redefinition 
block. Actually, in this 
implementation, only the 
first fourteen can be 


- changed in normal mode, 


and only: the first eleven 
in compressed mode. 
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These are the special characters which support the featrues of this 


implementation. They support horizontal smooth scrolling, the loadable 


‘font and ensure maximal processing time by reducing unnecessary DMA ~ 


activity by the Am8052. : 
First, the background function character which supports horizontal smooth 
scrolling in the background and the loadable font. There are two of them, 
and two associated attributes, to allow font loading of both normal and 
compressed mode characters. 

BgdFncChr0 — XDATA O9FCCH 

BgdFncChr1 XDATA O9FCDH 

_BgdFncAtr0 XDATA O9FCEH 

BgdFncAtr1 XDATA O9FDOH 


- 


Next, the message function character character which supports horizontal 

smooth scrolling in the message display and its associated attribute. 
MsgFnechr XDATA O9F1CH ‘ 
MsgFncAtr | XDATA O9F1EH 


Next, a latched attribute for use. with the termination row control block is 
defined. This is the extra row control block in the window display when it 


is not otherwise being used. If the window display is active then the extra | ..-, 


row control block in the background is used as the termination row control 
block. [It is pointed to by the last visible row in the background display, 
the last visible row in the window display, the message display row and the 
termination window definition block. The termination row control block is 


set to point to itself. By setting the character pointer to zero we force 


the Am8052 to use the fill code (defined in the main definition block) for 
the entire row. 
set, the termination attribute is fetched. Since this attribute is latched 
(the only latched attribute in the system), it forces all fill characters to 
have the same, blank attribute. By using this ‘termination row we avoid DMA 
activity by the Am8052 almost entirely during the time that the last two 
character rows are being displayed. (DMA occurs when the Am8052 pre-fetchs 
up to two extra rows.) Therefore, the processor has a nearly uninterrupted 
one-and-a-half milliseconds just prior to the time when the main definition 
block is fetched to begin the next frame. Any accesses made to display 
memory during this. end-of-frame time cannot interfere with video refresh. 
The timer 0 interrupt has been set to tell us when this time begins. 


TrmAtr O84FEH 





Because the FAT bit (also in the main definition block) is | : 


SOT-d 


- These are the active counts associated with each row in the system. They 
: tell us where the farthest right, non-blank character is in each row (i.e. 
: how much of the row we may need to erase). 


BgdActCntBuf XDATA O9FD2H . 


3; One byte for each background row 
_ WndActCntBuf XDATA O9FF1H 3; One byte for each window row 
MsgActCnt XDATA O9F1DH ; One byte for the one message row 


These are the bit tables for tab position storage. There is one table for 
each display, although the background table is actually in two parts. Each 


; 
; bit in a table corresponds to a column in the display. If the bit is set, 
; 


then that column is a tab location. 


NOTE: The following definitions are not supported by current software. 
‘They are for possible extensions to support horizontal tabulation. 
‘Vertical tabulation could also be supported by using an unused bit 
in each row control block (addressed in their physical memory order 
rather than their logical display order). The affect of these new 
capabilites on existing operations, and any necessary restrictions 
on their use, will need to be considered. 
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BgdTabTbILt - XDATA O8AF4H For left 96 columns of background 


BgdTabTblLRt : XDATA O8BF4H ; For right 32 columns of background 
MsgTabTbl — XDATA O9F20H | ; For all 128 columns of message 
; For all 40 columns of window 


WndTabTbl XDATA O8BFBH 


; These are the display dependent variable buffers. While a particular display 
; is active its variables are kept in internal RAM. When a different display 


7 becomes active the old display's variables are copied out to their external 


; RAM location and the new display's variables are copied in. 


BgdVarBuf XDATA O8CF4H 
MsgVarBuf XDATA O8DF4H 


WndVarBuf XDATA O8EF4H 


23 


; This is the serial communications ring buffer for receiving characters from 
3; the host computer. 


HstRcvBuf XDATA_O8FBOH 


ZEEEEEEEEEEEEEE EE EEE EEE EE EEE EEE EE EE THEE T TEETH TE TTF F ttt ttt ttt ttt ttt tt ttt ttt + 


SKIP 
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These are the locations of the’ various structures used in the initial 
clearing of the character generator RAM. They are in the same memory 
area where the background character buffers are located. When these 

buffers are initialized, the font clearing information (which will no 
longer be needed) will be overwritten with spaces. 
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ClrFntMDB XDATA 09030H 3; Main definition block 


ClrFntRCBBas XDATA 08030H : First row control block 
ClrfntChrBas” XDATA 08080H ; First character © 


s NOTE: The remaining fifteen RCBs and characters are at the same. 
: offsets in subsequent pages. 


ClrFntAtr XDATA 09080H ; Common attributes 
ClrFntRRB XDATA 09130H 3; Common row redefinition block 
ClrFntwWDB XDATA 09230H ; Termination window definition block 
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; end of C_MemMap 
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